Skip to content

API Tara: administration ​

Role administration (organization owner or admin)

This page is generated from openapi.yaml by npm run gen, so do not edit it by hand. Authentication is described on the overview page.

GET/v1/admin/membersAdmin

Members and roles of the current organization (organization owner or admin), via the Portal

Responses ​

CodeDescriptionType
200List of rolesapplication/json · object
401Not signed inapplication/problem+json · object
403Forbiddenapplication/problem+json · object

Example response ​

json
{
  "items": [
    {
      "login": "string",
      "name": "string",
      "signedIn": false,
      "org": "string",
      "role": "owner"
    }
  ]
}

Call with curl ​

bash
curl "https://tara.phillipcli.cloud/v1/admin/members" \
  -H "Authorization: Bearer $TARA_TOKEN"
POST/v1/admin/membersAdmin

Grant 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) ​

FieldTypeRequiredDescription
loginstringyes
orgstringyesOrganization slug
roleowner | admin | member | vieweryesRole 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 ​

CodeDescriptionType
204Granted (or already granted before)
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
403Forbiddenapplication/problem+json · object

Call with curl ​

bash
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"}'
DELETE/v1/admin/members/{login}/{org}Admin

Remove a member from an organization (org owner or admin; via the Portal); you cannot remove yourself

Parameters ​

NameInTypeRequiredDescription
loginpathstringyes
orgpathstringyesOrganization slug

Responses ​

CodeDescriptionType
204Removed; takes effect from that user's next request
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
403Forbiddenapplication/problem+json · object
404The user is not a member of this organizationapplication/problem+json · object

Call with curl ​

bash
curl -X DELETE "https://tara.phillipcli.cloud/v1/admin/members/<login>/<org>" \
  -H "Authorization: Bearer $TARA_TOKEN"
GET/v1/auditAdmin

Audit 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 ​

NameInTypeRequiredDescription
sincequerystring (date-time)From this time (inclusive)
untilquerystring (date-time)Until this time (exclusive)
actorquerystringUsername of the actor
actionquerystringEvent type (version.approve) or a whole group (version)
resourcequerystringResource name (including all its versions)
orgquerystringOrganization slug (default is the current organization)
limitqueryinteger
cursorquerystringCursor for the next page

Responses ​

CodeDescriptionType
200One page of the audit logapplication/json · object
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
403Forbiddenapplication/problem+json · object

Example response ​

json
{
  "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 ​

bash
curl "https://tara.phillipcli.cloud/v1/audit" \
  -H "Authorization: Bearer $TARA_TOKEN"
GET/v1/orgs/{org}/audit/export

Export 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 ​

NameInTypeRequiredDescription
orgpathstringyesOrganization slug (the caller must be a member; otherwise 404)
fromquerystring (date)yesFirst day (UTC
toquerystring (date)yesLast day (UTC
formatquerycsv | json

Responses ​

CodeDescriptionType
200The export. For json the body is {org, from, to, items} where items are AuditEntrytext/csv · string (binary)
400Invalid rangeapplication/problem+json · object
401Not signed inapplication/problem+json · object
402The plan does not include this feature (feature_not_in_plan, with feature and upgradeUrl)application/problem+json · object
403Forbiddenapplication/problem+json · object
404Not foundapplication/problem+json · object
503Tara has no signing key (TARA_SIGNING_KEY)application/problem+json · object

Call with curl ​

bash
curl "https://tara.phillipcli.cloud/v1/orgs/<org>/audit/export?from=string&to=string" \
  -H "Authorization: Bearer $TARA_TOKEN"
GET/v1/orgs/{org}/audit/export.sig

The 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 ​

NameInTypeRequiredDescription
orgpathstringyesOrganization slug (the caller must be a member; otherwise 404)
fromquerystring (date)yes
toquerystring (date)yes
formatquerycsv | json

Responses ​

CodeDescriptionType
200The signature fileapplication/json · object
400Invalid rangeapplication/problem+json · object
401Not signed inapplication/problem+json · object
402The plan does not include this feature (feature_not_in_plan, with feature and upgradeUrl)application/problem+json · object
403Forbiddenapplication/problem+json · object
404Not foundapplication/problem+json · object
503Tara has no signing key (TARA_SIGNING_KEY)application/problem+json · object

Example response ​

json
{
  "keyId": "string",
  "signed": "string",
  "signature": "string"
}

Call with curl ​

bash
curl "https://tara.phillipcli.cloud/v1/orgs/<org>/audit/export.sig?from=string&to=string" \
  -H "Authorization: Bearer $TARA_TOKEN"