API Tara: administration
Role administration (organization owner or admin)
This page is generated from
openapi.yamlbynpm run gen, so do not edit it by hand. Authentication is described on the overview page.
/v1/admin/membersAdminMembers and roles of the current organization (organization owner or admin), via the Portal
Responses
| Code | Description | Type |
|---|---|---|
| 200 | List of roles | application/json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
Example response
{
"items": [
{
"login": "string",
"name": "string",
"signedIn": false,
"org": "string",
"role": "owner"
}
]
}Call with curl
curl "https://tara.phillipcli.cloud/v1/admin/members" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/admin/membersAdminGrant a role in the current organization (owner or admin; only an owner grants owner), via the Portal; can be granted to someone who has never signed in
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
login | string | yes | |
org | string | yes | Organization slug |
role | owner | admin | member | viewer | yes | Role in an organization. owner and admin manage the organization and review its private resources; member uses Phillip and submits resources; viewer only reads in the browser (BA, PO, PM) and takes no paid seat. |
Responses
| Code | Description | Type |
|---|---|---|
| 204 | Granted (or already granted before) | |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/admin/members" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"login":"string","org":"string","role":"owner"}'/v1/admin/members/{login}/{org}AdminRemove a member from an organization (org owner or admin; via the Portal); you cannot remove yourself
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
login | path | string | yes | |
org | path | string | yes | Organization slug |
Responses
| Code | Description | Type |
|---|---|---|
| 204 | Removed; takes effect from that user's next request | |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
| 404 | The user is not a member of this organization | application/problem+json · object |
Call with curl
curl -X DELETE "https://tara.phillipcli.cloud/v1/admin/members/<login>/<org>" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/auditAdminAudit log of status, permission and report changes (org owner or admin see their organization; via session). The platform audit log is in the admin console
Newest rows first. Paginate with cursor taken from the previous page's nextCursor. The log contains no secrets: strings that look like tokens, private keys and passwords are masked.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
since | query | string (date-time) | From this time (inclusive) | |
until | query | string (date-time) | Until this time (exclusive) | |
actor | query | string | Username of the actor | |
action | query | string | Event type (version.approve) or a whole group (version) | |
resource | query | string | Resource name (including all its versions) | |
org | query | string | Organization slug (default is the current organization) | |
limit | query | integer | ||
cursor | query | string | Cursor for the next page |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | One page of the audit log | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
Example response
{
"items": [
{
"id": "string",
"at": "2026-11-01T00:00:00Z",
"actor": "string",
"action": "string",
"target": "string",
"org": "string",
"detail": {}
}
],
"nextCursor": "string",
"windowDays": 0,
"windowStart": "2026-11-01T00:00:00Z"
}Call with curl
curl "https://tara.phillipcli.cloud/v1/audit" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/orgs/{org}/audit/exportExport the audit log of a date range as CSV or JSON, signed with Tara's Ed25519 key (owner or admin, from a Portal or CLI session)
Same columns and rows as GET /v1/audit for the range, newest first, with secrets masked. from and to are UTC dates and both are included. The range cannot start before the audit window of the plan (Free 90 days, Team 1 year, Enterprise 3 years); a longer range answers 400 audit_window_exceeded. Cells that start with =, +, - or @ are prefixed with a single quote in the CSV so a spreadsheet does not run them as formulas.
Signature. X-Audit-Signature is the base64 Ed25519 signature of the ASCII text sha256:<hex>, where <hex> is the SHA-256 of the response body, made with Tara's package signing key; X-Audit-Key-Id is the id of that key (see GET /v1/signing-keys, which returns the public key). GET /v1/orgs/{org}/audit/export.sig returns the same signature as a file. Writing the export is recorded in the audit log (org.audit.export). Needs the audit-export feature (Team and Enterprise; 402 feature_not_in_plan on Free, which can still read the audit log on screen for its 90 days).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org | path | string | yes | Organization slug (the caller must be a member; otherwise 404) |
from | query | string (date) | yes | First day (UTC |
to | query | string (date) | yes | Last day (UTC |
format | query | csv | json |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | The export. For json the body is {org, from, to, items} where items are AuditEntry | text/csv · string (binary) |
| 400 | Invalid range | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 402 | The plan does not include this feature (feature_not_in_plan, with feature and upgradeUrl) | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
| 503 | Tara has no signing key (TARA_SIGNING_KEY) | application/problem+json · object |
Call with curl
curl "https://tara.phillipcli.cloud/v1/orgs/<org>/audit/export?from=string&to=string" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/orgs/{org}/audit/export.sigThe signature of the audit export of a date range, as a file (same parameters as the export)
Computed over the export as it is when called: for a range that has ended it equals X-Audit-Signature of the export, for a range that includes today it changes as the log grows. The body is JSON {keyId, signed, signature}.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org | path | string | yes | Organization slug (the caller must be a member; otherwise 404) |
from | query | string (date) | yes | |
to | query | string (date) | yes | |
format | query | csv | json |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | The signature file | application/json · object |
| 400 | Invalid range | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 402 | The plan does not include this feature (feature_not_in_plan, with feature and upgradeUrl) | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
| 503 | Tara has no signing key (TARA_SIGNING_KEY) | application/problem+json · object |
Example response
{
"keyId": "string",
"signed": "string",
"signature": "string"
}Call with curl
curl "https://tara.phillipcli.cloud/v1/orgs/<org>/audit/export.sig?from=string&to=string" \
-H "Authorization: Bearer $TARA_TOKEN"