API tokens
Create a token in Settings, API tokens. Send it as Authorization: Bearer tmanage_pat_… A token reaches one workspace and can be revoked at any time.
New · 4 min
See one request travel to approval
A short walkthrough, from the first ask to the approved version.
Watch the work storyTemplates
Templates for client delivery
Start from a ready request-to-approval flow for your kind of team.
Browse templatesPlaybook
The client approval playbook
How service teams get clear decisions from clients, on record, first time.
Read the playbookConnect your tools with a token or OAuth, stay inside the rate limits, receive signed webhooks and look up every endpoint.
Every request acts as one member of one workspace. The API checks that member’s permissions on every call.
Create a token in Settings, API tokens. Send it as Authorization: Bearer tmanage_pat_… A token reaches one workspace and can be revoked at any time.
Apps and AI assistants connect with OAuth 2.1 and PKCE. The member approves the scopes: read, write or manage. Billing is never included by default.
Over a limit, the API answers 429 Too Many Requests with a Retry-After header. Wait that many seconds, then try again.
Each delivery is signed. Check X-TManage-Signature (HMAC-SHA256 of timestamp and body) and refuse a timestamp more than 5 minutes off.
X-TManage-Timestamp: 1767225600 X-TManage-Signature: v1=<hex HMAC-SHA256(secret, "<timestamp>.<body>")> X-TManage-Event: work_item.created
Every endpoint of the contract, grouped by area.
/organizationscreateOrganizationIdempotency-Key · header · string · requiredCreateOrganizationRequest201 · Organization Organization and owner membership created transactionally.400 · Error Invalid request or transition.409 · Error Version, state, or idempotency fingerprint conflict.CreateOrganizationRequestname: string · requiredtimezone: string · requireddefaultLocale: en | ar · requiredOrganizationid: Id · requiredname: string · requiredslug: string · requiredtimezone: string · requireddefaultLocale: string · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/projectscreateProjectorganizationId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCreateProjectRequest201 · Project Project created403 · Error Principal lacks capability; response does not reveal hidden object details.CreateProjectRequestworkspaceId: Id · requiredname: string · requiredownerUserId: Id · requiredtargetAt: one oftemplate: agency_delivery | software_studio | consulting_engagementProjectid: Id · requiredorganizationId: Id · requiredworkspaceId: Id · requiredname: string · requiredownerUserId: Id · requiredcommittedAt: one offorecastAt: one ofErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/projects/{projectId}/client-organizationslinkClientOrganizationorganizationId · path · string (uuid) · requiredprojectId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredLinkClientOrganizationRequest201 · ClientOrganization Client organization linked with explicit policy403 · Error Principal lacks capability; response does not reveal hidden object details.LinkClientOrganizationRequestname: string · requiredapprovalPolicy: all_required | any_one | ordered · requireddefaultInvitationExpiryDays: integerClientOrganizationid: Id · requiredorganizationId: Id · requiredname: string · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/projects/{projectId}/client-requestslistClientRequestsorganizationId · path · string (uuid) · requiredprojectId · path · string (uuid) · requiredcursor · query · stringstatus · query · ClientRequestStatus200 · ClientRequestPage Authorized requestsClientRequestPageitems: ClientRequest[] · requirednextCursor: string | null/organizations/{organizationId}/projects/{projectId}/client-requestscreateClientRequestorganizationId · path · string (uuid) · requiredprojectId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCreateClientRequestRequest201 · ClientRequest Request submitted; desired date is not committed403 · Error Principal lacks capability; response does not reveal hidden object details.422 · Error Invalid request or transition.CreateClientRequestRequesttitle: string · requireddescription: object · requiredcategory: stringurgencyReason: stringdesiredAt: one offileAssetIds: Id[]ClientRequestid: Id · requiredprojectId: Id · requiredtitle: string · requireddescription: objectstatus: ClientRequestStatus · requireddesiredAt: one ofcommittedAt: one ofclientSafeReason: stringacceptedWorkItemId: one ofversion: integer · requiredcreatedAt: Timestamp · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/client-requests/{requestId}getClientRequestorganizationId · path · string (uuid) · requiredrequestId · path · string (uuid) · required200 · ClientRequest Client-safe or internal projection according to principal404 · Error Object absent or intentionally indistinguishable from inaccessible.ClientRequestid: Id · requiredprojectId: Id · requiredtitle: string · requireddescription: objectstatus: ClientRequestStatus · requireddesiredAt: one ofcommittedAt: one ofclientSafeReason: stringacceptedWorkItemId: one ofversion: integer · requiredcreatedAt: Timestamp · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/client-requests/{requestId}/transitionstransitionClientRequestorganizationId · path · string (uuid) · requiredrequestId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredTransitionClientRequest200 · ClientRequest Transition applied with audit event409 · Error Version, state, or idempotency fingerprint conflict.422 · Error Invalid request or transition.TransitionClientRequesttoStatus: ClientRequestStatus · requiredexpectedVersion: integer · requiredclientSafeReason: stringcommittedAt: one ofacceptedWork: one ofClientRequestid: Id · requiredprojectId: Id · requiredtitle: string · requireddescription: objectstatus: ClientRequestStatus · requireddesiredAt: one ofcommittedAt: one ofclientSafeReason: stringacceptedWorkItemId: one ofversion: integer · requiredcreatedAt: Timestamp · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/conversations/{conversationId}/messagescreateMessageorganizationId · path · string (uuid) · requiredconversationId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCreateMessageRequest201 · Message Message committed and assigned a sequenceCreateMessageRequestcontent: object · requiredparentMessageId: one ofclientGeneratedId: string · requiredMessageid: Id · requiredconversationId: Id · requiredauthorUserId: Id · requiredsequenceNo: integer · requiredcontent: object · requiredaudience: Audience · requiredcreatedAt: Timestamp · required/organizations/{organizationId}/messages/{messageId}/convertconvertMessageToWorkorganizationId · path · string (uuid) · requiredmessageId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredConvertMessageRequest201 · WorkItem Linked work item created without copying source context409 · Error Existing conversion returned or request fingerprint conflictWorkItemid: Id · requiredprojectId: Id · requiredsourceMessageId: one oftype: string · requiredtitle: string · requiredstate: string · requiredownerUserId: one ofdueAt: one ofaudience: Audience · requiredversion: integer · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/projects/{projectId}/work-itemscreateWorkItemorganizationId · path · string (uuid) · requiredprojectId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCreateWorkItemRequest201 · WorkItem Work item createdCreateWorkItemRequesttype: task | milestone | approval | request · requiredtitle: string · requiredstate: backlog | ready | in_progress | blocked | internal_review | done | archived · requiredownerUserId: one ofdueAt: one ofaudience: Audience · requiredWorkItemid: Id · requiredprojectId: Id · requiredsourceMessageId: one oftype: string · requiredtitle: string · requiredstate: string · requiredownerUserId: one ofdueAt: one ofaudience: Audience · requiredversion: integer · required/organizations/{organizationId}/work-items/{workItemId}updateWorkItemorganizationId · path · string (uuid) · requiredworkItemId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredUpdateWorkItemRequest200 · WorkItem Updated with optimistic version increment409 · Error Version, state, or idempotency fingerprint conflict.UpdateWorkItemRequestexpectedVersion: integer · requiredtitle: stringstate: stringownerUserId: one ofdueAt: one ofaudience: AudiencetransitionReason: stringWorkItemid: Id · requiredprojectId: Id · requiredsourceMessageId: one oftype: string · requiredtitle: string · requiredstate: string · requiredownerUserId: one ofdueAt: one ofaudience: Audience · requiredversion: integer · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/upload-sessionscreateUploadSessionorganizationId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCreateUploadSessionRequest201 · UploadSession Scoped multipart upload sessionCreateUploadSessionRequestfileName: string · requiredmimeType: string · requiredsizeBytes: integer · requiredcontentHash: stringpurpose: message_attachment | request_attachment | deliverable | document · requiredobjectId: IdUploadSessionid: Id · requiredexpiresAt: Timestamp · requiredpartSizeBytes: integer · requiredreservedBytes: integer · requireduploadUrls: object[] · required/organizations/{organizationId}/upload-sessions/{uploadSessionId}/completecompleteUploadSessionorganizationId · path · string (uuid) · requireduploadSessionId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCompleteUploadRequest202 · FileAsset Upload accepted for verification and scanCompleteUploadRequestparts: object[] · requiredFileAssetid: Id · requiredname: string · requiredstatus: created | uploading | uploaded | verifying | scanning | ready | rejected | expired | cancelled · required/organizations/{organizationId}/projects/{projectId}/deliverablescreateDeliverableorganizationId · path · string (uuid) · requiredprojectId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCreateDeliverableRequest201 · Deliverable Deliverable created internal by defaultCreateDeliverableRequesttitle: string · requireddescription: stringDeliverableid: Id · requiredprojectId: Id · requiredtitle: string · requiredstatus: string · required/organizations/{organizationId}/deliverables/{deliverableId}/versionscreateDeliverableVersionorganizationId · path · string (uuid) · requireddeliverableId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredCreateDeliverableVersionRequest201 · DeliverableVersion Immutable version created422 · Error Invalid request or transition.CreateDeliverableVersionRequestfileVersionIds: Id[] · requiredsummary: string · requiredcriteria: string[]DeliverableVersionid: Id · requireddeliverableId: Id · requiredversionNo: integer · requiredcontentHash: string · requiredstatus: string · requiredpublishedAt: one ofErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/deliverable-versions/{versionId}/client-previewpreviewClientProjectionorganizationId · path · string (uuid) · requiredversionId · path · string (uuid) · requiredClientPreviewRequest200 · ClientPreview Real-policy client projection plus warningsClientPreviewRequestclientOrganizationId: Id · requiredrole: client_admin | client_reviewer | client_member | client_viewer · requiredClientPreviewprojection: object · requiredwarnings: object[] · requiredpolicyFingerprint: string · required/organizations/{organizationId}/deliverable-versions/{versionId}/publishpublishDeliverableVersionorganizationId · path · string (uuid) · requiredversionId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredPublishDeliverableRequest201 · Approval Client projection and approval created transactionally422 · Error Invalid request or transition.PublishDeliverableRequestclientOrganizationId: Id · requiredreviewerUserIds: Id[] · requiredapprovalPolicy: all_required | any_one | ordered · requireddueAt: one ofexpectedContentHash: string · requiredpolicyFingerprint: string · requiredApprovalid: Id · requireddeliverableVersion: DeliverableVersion · requiredcontentHash: string · requiredstatus: draft | requested | viewed | approved | changes_requested | expired | cancelled | invalidated · requireddueAt: one ofreviewers: object[] · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/approvals/{approvalId}getApprovalorganizationId · path · string (uuid) · requiredapprovalId · path · string (uuid) · required200 · Approval Reviewer-safe exact governed version404 · Error Object absent or intentionally indistinguishable from inaccessible.Approvalid: Id · requireddeliverableVersion: DeliverableVersion · requiredcontentHash: string · requiredstatus: draft | requested | viewed | approved | changes_requested | expired | cancelled | invalidated · requireddueAt: one ofreviewers: object[] · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/approvals/{approvalId}/decisionsdecideApprovalorganizationId · path · string (uuid) · requiredapprovalId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredApprovalDecisionRequest201 · ApprovalDecision Immutable reviewer decision409 · Error Version, state, or idempotency fingerprint conflict.422 · Error Invalid request or transition.ApprovalDecisionRequestdecision: approved | changes_requested · requiredexpectedContentHash: string · requiredfeedback: object[]ApprovalDecisionid: Id · requiredapprovalId: Id · requiredreviewerUserId: Id · requireddecision: string · requiredcontentHash: string · requireddecidedAt: Timestamp · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object/organizations/{organizationId}/homegetHomeorganizationId · path · string (uuid) · required200 · Home Permission-filtered My DayHomerecommended: object[]due: WorkItem[]blocked: WorkItem[]waiting: object[]/organizations/{organizationId}/inboxgetInboxorganizationId · path · string (uuid) · requiredcursor · query · stringmode · query · important | all | waiting_on_me | client_actions200 · InboxPage Recipient-only notification bundlesInboxPageitems: object[] · requirednextCursor: string | null/organizations/{organizationId}/searchsearchorganizationId · path · string (uuid) · requiredq · query · string · requiredtype · query · string[]cursor · query · string200 · SearchPage Authorized results onlySearchPageitems: object[] · requirednextCursor: string | null/organizations/{organizationId}/members/{membershipId}/offboarding-impactgetOffboardingImpactorganizationId · path · string (uuid) · requiredmembershipId · path · string (uuid) · required200 · OffboardingImpact Ownership/access impact without executing changesOffboardingImpactactiveSessions: integerownedWorkCount: integerpendingApprovalCount: integerexternalShareCount: integerrequiredTransferTypes: string[]/organizations/{organizationId}/members/{membershipId}/offboardoffboardMemberorganizationId · path · string (uuid) · requiredmembershipId · path · string (uuid) · requiredIdempotency-Key · header · string · requiredOffboardMemberRequest202 · OffboardingJob Membership suspended immediately; transfer workflow startedOffboardMemberRequesttransferToUserId: Id · requiredconfirmation: string · requiredOffboardingJobid: Id · requiredstatus: suspending | transferring | reviewing_external_access | completed | failed_partial · required/organizations/{organizationId}/audit-eventslistAuditEventsorganizationId · path · string (uuid) · requiredcursor · query · stringaction · query · stringactorId · query · string (uuid)200 · AuditPage Scope-redacted audit eventsAuditPageitems: object[] · requirednextCursor: string | null/organizations/{organizationId}/billing/usagegetOrganizationPlanUsageorganizationId · path · string (uuid) · required200 · OrganizationPlanUsage Authorized workspace plan and usage summary. Client principals and ordinary members cannot read billing data.403 · Error Principal lacks capability; response does not reveal hidden object details.OrganizationPlanUsageplanCode: string · requiredplanVersion: integer · requireddimensions: UsageDimension[] · requiredclientUsersIncluded: boolean · requiredmeasuredAt: Timestamp · requiredErrorcode: string · requiredmessage: string · requiredcorrelationId: Id · requiredfieldErrors: object