Acuity PPM API

Tokens and authentication

Where do I get `Company-Api-Token`?

Ask Acuity Support for your company token, or find it in:

Project -> Information -> Gear -> Company Api Token

What is the difference between `Company-Api-Token` and `api-token`?

In the current documentation UI, they are treated as the same saved value because they represent the same company-level token in the examples we support today.

What are `api-auth` and `api-secret` used for?

They are required for /api/v1/... endpoints such as:

GET /project
POST /project
PUT /project
GET /proposal
POST /proposal
PUT /proposal

Records and identifiers

What is `record-token`?

record-token is the target record identifier used by endpoints such as GET /project and GET /proposal.

For project and proposal retrieval, this value is usually the project_token returned by a list endpoint.

What is `record-id`?

record-id is the numeric record identifier used by some endpoints such as GET /project/task.

For task retrieval, record-id maps to the task id.

Domains and environments

Why do the examples use `https://domain/...`?

Acuity PPM can be deployed in different customer or regional environments. The docs use domain as a placeholder so the examples are not tied to a single host.

Why does an endpoint exist in GitHub docs but not in my environment?

Some routes may be available only in specific environments, feature sets, or application versions. When live behavior differs from the markdown source, the docs are aligned to the currently verified API behavior.

FAQ