Projects
`/projects`
One page of records, newest first unless you say otherwise, with the total count in meta so you know how far to paginate.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
page?integer1-based. meta.totalPages says how many there are.
1 <= value1per_page?integerRows per page. A value above 200 returns 400 - never a silent clamp.
1 <= value <= 20050sort?stringPrefix with - for descending. An undeclared sort returns 400.
"-createdAt""createdAt""-createdAt""name""-name""status""-status"q?stringCase-insensitive "contains", across: name.
filter[status]?stringExact match on status.
filter[clientId]?stringExact match on clientId.
filter[parentId]?stringExact match on parentId.
The requested page.
application/json- response
data*array<>meta*curl -X GET 'https://api.usedashly.com/v1/projects'{ "data": [ { "id": "string", "clientId": "string", "parentId": "string", "name": "string", "description": "string", "status": "string", "recurrencePeriod": "monthly", "startsOn": "2019-08-24", "endsOn": "2019-08-24", "dealId": "string", "stagingUrls": null, "siteUrl": "string", "isPoc": true, "createdAt": "2019-08-24T14:15:22Z" } ], "meta": { "page": 0, "perPage": 0, "total": 0, "totalPages": 0 }}Links are given as the target's public id (clientId: "hsbftmp3f5"); the API resolves them server-side. Fields the database requires but the interface decides for you are filled in the same way here.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
name*string1 <= length <= 200description?string|nullstatus?stringlength <= 40clientId?string|nullprojectTypeId?string|nullrecurrencePeriod?|nullstagingUrls?array<>items <= 10isPoc?booleanparentId?string|nullsiteUrl?|nullcreatedAt?stringWhen this actually happened, for an import. Past dates only; defaults to now. updatedAt follows it unless the body sets one.
date-timeCreated. The body is the new record, as a read would return it.
application/json- response
data*curl -X POST 'https://api.usedashly.com/v1/projects' \ -H 'Content-Type: application/json' \ -d '{ "name": "string"}'{ "data": { "id": "string", "clientId": "string", "parentId": "string", "name": "string", "description": "string", "status": "string", "recurrencePeriod": "monthly", "startsOn": "2019-08-24", "endsOn": "2019-08-24", "dealId": "string", "stagingUrls": null, "siteUrl": "string", "isPoc": true, "createdAt": "2019-08-24T14:15:22Z" }}The full record, custom fields included when the resource carries them. A record from another agency is a 404, not a 403 - its existence is not ours to confirm.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe record's public id (hsbftmp3f5), as returned in the id field. An internal UUID returns 404.
Found.
application/json- response
data*curl -X GET 'https://api.usedashly.com/v1/projects/string'{ "data": { "id": "string", "clientId": "string", "parentId": "string", "name": "string", "description": "string", "status": "string", "recurrencePeriod": "monthly", "startsOn": "2019-08-24", "endsOn": "2019-08-24", "dealId": "string", "stagingUrls": null, "siteUrl": "string", "isPoc": true, "createdAt": "2019-08-24T14:15:22Z" }}A partial update: only the fields you send change. One exception - customFields is replaced wholesale, not merged, so sending it with a single key clears the others. Read the record, merge, then write.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe record's public id (hsbftmp3f5), as returned in the id field. An internal UUID returns 404.
application/json- body
name?string1 <= length <= 200description?string|nullstatus?stringlength <= 40clientId?string|nullprojectTypeId?string|nullrecurrencePeriod?|nullstagingUrls?array<>items <= 10isPoc?booleanparentId?string|nullsiteUrl?|nullUpdated. The body is the record as it now stands.
application/json- response
data*curl -X PATCH 'https://api.usedashly.com/v1/projects/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "data": { "id": "string", "clientId": "string", "parentId": "string", "name": "string", "description": "string", "status": "string", "recurrencePeriod": "monthly", "startsOn": "2019-08-24", "endsOn": "2019-08-24", "dealId": "string", "stagingUrls": null, "siteUrl": "string", "isPoc": true, "createdAt": "2019-08-24T14:15:22Z" }}Permanent. The audit log keeps the trace; the record does not come back.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe record's public id (hsbftmp3f5), as returned in the id field. An internal UUID returns 404.
Deleted. Empty body.
curl -X DELETE 'https://api.usedashly.com/v1/projects/string'Every verb this resource answers to, with its target and the JSON Schema of its body - the same contracts this document describes, readable at runtime.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
The available verbs.
application/json- response
data*array<>curl -X GET 'https://api.usedashly.com/v1/projects/actions'{ "data": [ { "name": "string", "label": "string", "description": "string", "target": "item", "readOnly": true, "path": "string", "input": {} } ]}Shares this project with an already-linked partner agency. Idempotent: re-sharing reactivates a revoked share. allowWidget explicitly grants or revokes widget access; omitting it preserves the previous permission.
Does what the dashboard's shareProjectAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
partnerOrgId*string1 <= lengthallowWidget?booleanDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/share-with-partner' \ -H 'Content-Type: application/json' \ -d '{ "partnerOrgId": "string"}'{ "data": null}Removes a partner's access to this shared project: a partner agency by partnerOrgId, or a partner of /v1/partners (an independent or a company) by partnerId. Name exactly one.
Does what the dashboard's revokeProjectShareAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
partnerOrgId?string1 <= lengthpartnerId?string1 <= lengthDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/revoke-share' \ -H 'Content-Type: application/json' \ -d '{}'{ "data": null}Invites an outside person onto this project by email - creating the CRM person, the partner and the seat when needed - and shares the project with them. Idempotent on the address: re-running refreshes the invitation link. company makes that agency (found by name or created) the partner, instead of the person as an independent. allowTime is only honoured on a new share. allowWidget explicitly grants or revokes widget access, including on existing shares; omitting it preserves the previous permission.
Does what the dashboard's inviteOnProjectAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
email*string^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$emailname?stringlength <= 120allowTime?booleanallowWidget?booleancompany?string2 <= length <= 120Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/invite-person' \ -H 'Content-Type: application/json' \ -d '{ "email": "user@example.com"}'{ "data": null}Adds an agency member to this project, optionally with their role on it (free text, 80 characters). memberId is the member's user id, the one the members resource returns. Already assigned: nothing changes, except the role when one is given.
Does what the dashboard's addProjectMemberAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
memberId*string1 <= lengthrole?stringlength <= 80Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/add-member' \ -H 'Content-Type: application/json' \ -d '{ "memberId": "string"}'{ "data": null}Sets what an agency member does on this project (role, free text, 80 characters; null or "" clears it). The member must already be on the project.
Does what the dashboard's setProjectMemberRoleAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
memberId*string1 <= lengthrole*|nullDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/set-member-role' \ -H 'Content-Type: application/json' \ -d '{ "memberId": "string", "role": "string"}'{ "data": null}Removes an agency member from this project. memberId is the member's user id. Not assigned does nothing.
Does what the dashboard's removeProjectMemberAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
memberId*string1 <= lengthDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/remove-member' \ -H 'Content-Type: application/json' \ -d '{ "memberId": "string"}'{ "data": null}Sets the project's planned start and end (startsOn, endsOn: YYYY-MM-DD, or null for none). The end may not precede the start. Read back as startsOn / endsOn on the project.
Does what the dashboard's setProjectDatesAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
startsOn*string|nullendsOn*string|nullDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/set-dates' \ -H 'Content-Type: application/json' \ -d '{ "startsOn": "string", "endsOn": "string"}'{ "data": null}Turns cycles on or changes them — weeks (1-4) and anchorOn (YYYY-MM-DD, the earliest day the next cycle may start) — creating the current cycle and the two after it; or turns them off with weeks: null (the cycles and their tickets stay).
Does what the dashboard's setCycleSettingsAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
weeks*|nullanchorOn?string|nullDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/set-cycles' \ -H 'Content-Type: application/json' \ -d '{ "weeks": -9007199254740991}'{ "data": null}The deals of this project — planned on it, linked to it, or selling one of its roadmap milestones — each with its amount excl. tax (per period when recurring), kind, status, stage, milestone, linked Pennylane quotes and attached invoices; the planned milestones (no deal yet) with their estimate; and the totals: oneShotSignedCents (won), oneShotPipeCents (open, unweighted), oneShotPlannedCents (estimates), mrrCents (won recurring, per month) totalValueCents (all of them, recurring over 12 months), invoicedCents (invoices attached to won one-shot deals, excl. tax) and leftToInvoiceCents (each won one-shot block's amount minus its invoices). A deal's milestone.amountCents is the block's own amount when one was confirmed at the win (null = the deal's amount), and it is what the totals count. Lost deals are listed but counted nowhere. Needs deals:read as well. Read-only.
Reads the same data as the in-app listProjectDeals - same implementation. Changes nothing; also answers GET with the same fields as query parameters.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
The figures.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X GET 'https://api.usedashly.com/v1/projects/string/actions/deals'{ "data": null}The deals of this project — planned on it, linked to it, or selling one of its roadmap milestones — each with its amount excl. tax (per period when recurring), kind, status, stage, milestone, linked Pennylane quotes and attached invoices; the planned milestones (no deal yet) with their estimate; and the totals: oneShotSignedCents (won), oneShotPipeCents (open, unweighted), oneShotPlannedCents (estimates), mrrCents (won recurring, per month) totalValueCents (all of them, recurring over 12 months), invoicedCents (invoices attached to won one-shot deals, excl. tax) and leftToInvoiceCents (each won one-shot block's amount minus its invoices). A deal's milestone.amountCents is the block's own amount when one was confirmed at the win (null = the deal's amount), and it is what the totals count. Lost deals are listed but counted nowhere. Needs deals:read as well. Read-only.
Reads the same data as the in-app listProjectDeals - same implementation. Changes nothing; also answers GET with the same fields as query parameters.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/deals' \ -H 'Content-Type: application/json' \ -d '{}'{ "data": null}Adds parts to this project in one transaction (no row may be isSource): one roadmap milestone per one-shot row, one deal of the project's client per ticked row. Each row of rows (1 to 20) is a part: name, kind (one_shot | recurring), amountCents (excl. tax; per period when recurring), createDeal (true: a deal now on the follow-up pipeline; false: a planned milestone holding the amount as its estimate for a one-shot row, nothing stored yet for a recurring row, returned in skipped). A one-shot row is a roadmap milestone: startsOn, endsOn (YYYY-MM-DD) and precision (day | month | quarter | half) together, or none. A recurring row takes period (default monthly), start ({kind: on_win}, {kind: date, on} or {kind: after_row, row} naming a one-shot row of the same body by its index) and commitmentMonths. New deals belong to the same client and contact, are planned to join the project, and are expected to close when their milestone (or their recurrence) starts. When the agency has several follow-up pipelines, name one by its public id in followUpPipelineId (refusal follow_up_pipeline_required lists them); with none, the refusal is no_follow_up_pipeline. roadmapClientVisible: true (the 'show the roadmap to the client' box) writes the milestones visible in the client's roadmap; absent or false, they stay internal until the agency shows them. The same idempotencyKey sent again answers the first result (replayed: true); with another body it answers 409 split_key_reused. Needs deals:write as well. Returns the deals and milestones by public id.
Does what the dashboard's splitIntoPartsAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
rows*array<>1 <= items <= 20followUpPipelineId?|nullidempotencyKey*string^[A-Za-z0-9_.:-]{8,255}$roadmapClientVisible?boolean|nullDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/add-parts' \ -H 'Content-Type: application/json' \ -d '{ "rows": [ { "name": "string", "kind": "one_shot", "createDeal": true } ], "idempotencyKey": "string"}'{ "data": null}Merges the listed projects (sourceIds, public ids) into this one, in one transaction: their tickets (with this project's client), milestones, documents, deals (each deal is kept and now points here), time, billing, chat, portal items, members, teams and partner shares, relations and history move here; what this project already has (a member, a team, a share, an SEO checklist, a widget site) and the sources' cycles stay on the sources, which are archived, never deleted. A source of another client needs confirmClientChange: true; widenDates widens this project's dates to cover theirs; dryRun: true answers the counts (moved, kept) and conflicts without writing. Re-running the same merge changes nothing (alreadyMerged).
Does what the dashboard's mergeProjectsAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
sourceIds*array<>1 <= items <= 50confirmClientChange?booleandryRun?booleanwidenDates?booleanDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/merge' \ -H 'Content-Type: application/json' \ -d '{ "sourceIds": [ "string" ]}'{ "data": null}The catalogue ids of the services this project runs on (Webflow, Vercel, Supabase…), in the order they were linked. Read-only.
Reads the same data as the in-app listProjectServices - same implementation. Changes nothing; also answers GET with the same fields as query parameters.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
The figures.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X GET 'https://api.usedashly.com/v1/projects/string/actions/stack'{ "data": null}The catalogue ids of the services this project runs on (Webflow, Vercel, Supabase…), in the order they were linked. Read-only.
Reads the same data as the in-app listProjectServices - same implementation. Changes nothing; also answers GET with the same fields as query parameters.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/stack' \ -H 'Content-Type: application/json' \ -d '{}'{ "data": null}linked: true puts a catalogue service on the project's stack (and, for a client project, on the client's services); linked: false takes it off the stack only. Idempotent. Answers the stack.
Does what the dashboard's setProjectServiceAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
serviceId*stringlinked*booleanDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/set-service' \ -H 'Content-Type: application/json' \ -d '{ "serviceId": "string", "linked": true}'{ "data": null}Links the services of a stack template the project does not run on yet; never unlinks one. Templates: webflow-site, framer-site, shopify-store, wordpress-site, web-app, seo, ads. Answers the stack.
Does what the dashboard's applyStackTemplateAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
templateId*string1 <= length <= 64Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/apply-stack-template' \ -H 'Content-Type: application/json' \ -d '{ "templateId": "string"}'{ "data": null}The repositories linked to this project with what GitHub last said about each (default branch, last commits, open pull requests, latest release or tag, CI status of the default branch, open issue count — cached, refreshed by webhooks and every few hours), and the pull requests linked to the project's tickets (a ticket's public id in the PR's title or branch, or AGD- anywhere). Read-only.
Reads the same data as the in-app listProjectRepositories - same implementation. Changes nothing; also answers GET with the same fields as query parameters.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
The figures.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X GET 'https://api.usedashly.com/v1/projects/string/actions/repositories'{ "data": null}The repositories linked to this project with what GitHub last said about each (default branch, last commits, open pull requests, latest release or tag, CI status of the default branch, open issue count — cached, refreshed by webhooks and every few hours), and the pull requests linked to the project's tickets (a ticket's public id in the PR's title or branch, or AGD- anywhere). Read-only.
Reads the same data as the in-app listProjectRepositories - same implementation. Changes nothing; also answers GET with the same fields as query parameters.
Required scope: projects:read.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/repositories' \ -H 'Content-Type: application/json' \ -d '{}'{ "data": null}Links owner/repo (or its URL) to the project and reads it from GitHub at once — through the agency's GitHub App when installed, anonymously otherwise (public repositories only). 409 already_linked, 409 too_many_repositories past 10. Answers the repositories.
Does what the dashboard's addProjectRepositoryAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
repository*string3 <= length <= 300Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/link-repository' \ -H 'Content-Type: application/json' \ -d '{ "repository": "string"}'{ "data": null}Takes a linked repository (its id from repositories) off the project. The repository itself and the tickets' links are untouched. Answers the repositories.
Does what the dashboard's removeProjectRepositoryAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
repositoryId*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/unlink-repository' \ -H 'Content-Type: application/json' \ -d '{ "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0"}'{ "data": null}Reads one linked repository from GitHub now instead of waiting for the next webhook or poll. A refusal from GitHub is stored as the repository's syncError, the last snapshot kept. Answers the repositories.
Does what the dashboard's refreshProjectRepositoryAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
repositoryId*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidDone.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/refresh-repository' \ -H 'Content-Type: application/json' \ -d '{ "repositoryId": "5aa3e9fa-2d0a-4c21-ad54-43217e2bc9c0"}'{ "data": null}Creates a relation between this record and a target object (targetType plus the target's public targetId) in the relation graph. Linking the same pair twice does nothing.
Does what the dashboard's linkObjectAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
targetType*string"account""contact""project""ticket""deal""user""proposal"targetId*string1 <= length <= 60Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/link-object' \ -H 'Content-Type: application/json' \ -d '{ "targetType": "account", "targetId": "string"}'{ "data": null}Removes the relation between this record and the target object in the relation graph. Unlinking a pair that was never linked does nothing. A deal/project pair is unlinked like unlink-project on the deal: the change is audited, so the key must be attached to a user (403 with reason key_not_attached otherwise).
Does what the dashboard's unlinkObjectAction does - same implementation, so the two cannot diverge.
Required scope: projects:write.
bearerAuthAuthorizationBearer <token>Your agency's API key: Authorization: Bearer ak_…. Created in Connectors → API & webhooks and shown once. A key authenticates an agency, not a person.
id*stringThe public id of the record to act on. It is resolved inside your agency before the action runs, so an id from another tenant is a 404 and never reaches it.
Idempotency-Key?stringA value you choose (a UUID is the usual one), 8 to 255 characters of A-Z a-z 0-9 _ . : -. Retrying with the same key returns the first call's answer instead of creating a second record, for seven days. The same key with a different body returns 409.
8 <= length <= 255application/json- body
targetType*string"account""contact""project""ticket""deal""user""proposal"targetId*string1 <= length <= 60Done.
application/json- response
data*unknownThe action's result; its shape depends on the verb.
curl -X POST 'https://api.usedashly.com/v1/projects/string/actions/unlink-object' \ -H 'Content-Type: application/json' \ -d '{ "targetType": "account", "targetId": "string"}'{ "data": null}