An API key lets a script, an integration or the DevStride MCP server act in DevStride as the member who created it, with exactly that member's access. Keys are personal credentials, so they live under My Account → API Keys rather than in organization settings, but this page is the full reference for both members and administrators.
From the table you can edit a key's label or delete it. Deleting revokes it immediately, so anything still using it needs a new key.
| To do this | You need |
|---|---|
| Create a key | Create API keys (CREATE_API_KEY), granted to every default role |
| Relabel or delete your own keys | Manage own API keys (MANAGE_OWN_API_KEYS), granted to every default role |
| See and revoke every member's keys | Manage all API keys (MANAGE_ALL_API_KEYS), Owner and Admin by default |
See Roles and Permissions for how these are assigned.
A role with Manage all API keys sees an extra All Organization Api Keys table on the same page. It lists every member's keys with the owner's name, label and public identifier, so you can see what is in use and relabel or delete any of them, for example when someone leaves or a key appears in the wrong place. Secrets are never shown here; only the owner saw the secret, once, at creation.
Each organization's API keys and MCP connections share one budget of 1,000 requests per minute. Requests over it are refused with HTTP 429 Too Many Requests, a Retry-After header giving the seconds until the minute resets, and a JSON body whose code is AUTH.ORGANIZATION_RATE_LIMIT_EXCEEDED and whose metadata carries limitPerMinute, retryAfterSeconds and windowResetsAt. Wait for the reset before retrying; a retry sooner is refused again. The DevStride MCP passes the wait on in its tool error, so an AI agent backs off by itself. Using DevStride in the browser never counts against the budget. If your integration needs more, contact support.
The app has said Status and Workstream for a while; the API, the generated SDKs, the real-time events and the MCP tools now use the same words. The old names went through a compatibility window, and on November 7, 2026 they were retired. Integrators were told on November 1.
| Old name (retired) | New name |
|---|---|
lane — laneId, laneRank, laneCollectionId and other lane* keys and values | status — statusId, statusRank, statusCollectionId |
folder — folderNumber and other folder* keys and values, folder-* real-time events | workstream — the workstream* keys and values, workstream-* real-time events |
Since the retirement:
400 Bad Request, before anything is changed. This covers body and query keys, values such as a sort field or an export column, and MCP tool arguments. The JSON body lists each old name it found and the one to send instead, so a failing script tells you exactly what to change:{
"code": "CONTRACT_RETIRED",
"message": "This request uses names that have been removed: body.laneId (use statusId).",
"retired": [{ "token": "body.laneId", "use": "statusId" }],
"upgrade": { "docs": "https://api-docs.devstride.com" }
}
folderCount and foldersUpdated) are gone./folders reads, GET /folders/{itemNumber} and POST /folders/batch, answer HTTP 410 Gone with a body naming the /workstreams replacement.workstream-* names. The folder-* events are no longer sent, so bind the workstream-* names.status and statusId; lane and laneId are refused.Board folders in Plan Delivery are not part of this rename and keep their name.
The old-name paths and MCP tools below were removed on October 10, 2026, after a week in which nobody called them. Each one has a status- or workstream-named replacement that behaves identically, and the retired paths no longer appear in the API reference.
Retired path (under /v1/organizations/{organizationId}) | Use instead |
|---|---|
POST /lanes | POST /statuses |
PATCH /lanes/{statusId}, DELETE /lanes/{statusId} | PATCH /statuses/{statusId}, DELETE /statuses/{statusId} |
POST /lane-collections | POST /status-collections |
PATCH /lane-collections/{statusCollectionId}, DELETE /lane-collections/{statusCollectionId} | PATCH /status-collections/{statusCollectionId}, DELETE /status-collections/{statusCollectionId} |
GET /analytics/cumulative-lane-items | GET /analytics/cumulative-status-items |
POST /folders | POST /workstreams |
PATCH /folders/{itemNumber}, DELETE /folders/{itemNumber} | PATCH /workstreams/{itemNumber}, DELETE /workstreams/{itemNumber} |
PATCH /folders/{itemNumber}/archive, PATCH /folders/{itemNumber}/unarchive | PATCH /workstreams/{itemNumber}/archive, PATCH /workstreams/{itemNumber}/unarchive |
PATCH /folders/{itemNumber}/relationships | PATCH /workstreams/{itemNumber}/relationships |
PATCH /folders/archive | PATCH /workstreams/archive |
A call to a retired /lanes, /lane-collections or analytics path is still checked for your key and access as before, then answered with HTTP 410 Gone and a JSON body that names the replacement, so a failing script tells you exactly what to change:
{
"code": "CONTRACT_RETIRED",
"message": "POST /v1/organizations/{organizationId}/lanes (createLaneDeprecated) has been removed. Use POST /v1/organizations/{organizationId}/statuses (createStatus).",
"upgrade": {
"operationId": "createStatus",
"method": "POST",
"path": "/v1/organizations/{organizationId}/statuses",
"docs": "https://api-docs.devstride.com"
}
}
The seven retired /folders write paths were removed altogether on October 31, 2026, after a further week in which nobody called them. They now answer a plain HTTP 404 Not Found that names no replacement; use the /workstreams paths in the table. The two /folders reads were retired on November 7, 2026, as described under Vocabulary changes.
The MCP server no longer offers create_lane, update_lane, delete_lane, create_lane_collection, update_lane_collection, delete_lane_collection, create_folder, update_folder, delete_folder, archive_folder or unarchive_folder. Use the matching *_status, *_status_collection and *_workstream tools, which do the same job. rank_item no longer accepts the scope lane; use status.
What DevStride stores uses the new names, and settings saved before the change have been converted, so anything that reads these values back sees the new spelling. Send the new spelling when you write them; the old one is refused like any other retired name.
statusId (for example $.statusId), a change-status action stores statusId, and the Service Desk action that follows a customer status stores the value type service-desk-status (formerly service-desk-lane). Workstream triggers and actions use the workstream names.itemStatus. createWorkflow and updateWorkflow refuse a condition or action that still names an old status reference, or a template that uses itemLane, with the CONTRACT_RETIRED body shown above; GET organization no longer lists variables.itemLane. A calculated field's formula that uses ${itemLane} is refused the same way, unless your organization has a custom field named Lane.statusModified; laneModified is refused.data is stored as version 2, which uses the new names (for example filters.statusId). A version-1 body in the new names is accepted, stored as version 2 and returned as version 2. A save that still names an old status spelling (a filter key, an advanced-filter rule field, a sort, a view mode or an axis) is refused with the CONTRACT_RETIRED body, naming the spelling to send; workstream filter keys are still converted for you.filterSchemaVersion 1 or 2; SLA reports filter by statusId.statusCollectionId and statusMappings; laneCollectionId and laneMappings are refused.Since November 11, 2026, item history, notifications and the activity log say status too (automation runs and import records since November 12), including the records written before the change, which were converted once. Reads return only the new values, and a filter that sends an old one is refused with HTTP 400 and the CONTRACT_RETIRED body shown above.
findNotifications): a status change has the action status_modified. Filtering by lane_modified is refused.getItemTransactions): status moves are added_to_status and removed_from_status. The trending reports (getTrendingItems, getTrendingItemCounts) refuse added_to_lane and removed_from_lane in transactionTypes.findActivityLogs): entries carry statusId, statusRank and rootWorkstreamNumber, older entries included; laneId, laneRank and rootFolderNumber no longer appear.lane, laneId, laneRank, hasExplicitClosedLane, laneChangedAt and rootFolder no longer appear.StatusEntity, StatusCollectionEntity and WorkstreamEntity, older imports included. An old import whose converted file has been removed cannot be run again; upload the file again to import it.The MCP tools that read these records return the same new values. The read-only database stores them too.
workstream for an item typeWherever an item type or a relationship entity used to take folder, send and read workstream. Responses return workstream without any opt-in; ?contract=workstream-v2 is still accepted and changes nothing. A request pinned with ?contract=workstream-v1 is refused with HTTP 400, naming workstream-v2.
Links to a workstream open the map with ?selectedWorkstream=. Links in older messages that use ?selectedFolder= still open the map, but no longer select the workstream: change them to ?selectedWorkstream=.
Every saved view carries a dataVersion that moves forward each time its data is saved. When you update a view's data, send the dataVersion you last read as expectedDataVersion. If the view has been saved since, the update is refused with HTTP 409 instead of overwriting the newer version; read the view again, re-apply your change and retry. Leave expectedDataVersion out to save without the check.
When you create a saved view or update its data, DevStride stores only the options that the view's screen (its location) defines. An option the screen does not define, for example one it has since retired, is left out without an error, so sending back what you read keeps working. An option the screen does define must hold a value of the right kind, such as true or false for an on/off option: otherwise the request is refused with HTTP 400 Bad Request, naming the option, and nothing is saved. The request and response shapes are unchanged. Time Allocation Matrix views keep their own check, which refuses an option it does not know.