How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Craft.io Work Items and OKRs API

Work items are the main building blocks of your product’s roadmap, and include Products, Epics, Features and Sub Features. OKRs are the goal-setting framework of your product’s roadmap, and include Objectives and Key Results.

Craft.io Work Items and OKRs API is one of 9 APIs that Craft.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Work Items and OKRs. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 9 operations across 7 paths, and defines 40 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, /.

9 operations 7 paths 40 schemas 1 DELETE6 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.craft.io
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Craft.io Work Items and OKRs API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (api_key).

Paths & Operations 9

Across 7 paths, the API surfaces 9 operations — 1 DELETE, 6 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Work Items and OKRs 9

Work items are the main building blocks of your product’s roadmap, and include Products, Epics, Features and Sub Features. OKRs are the goal-setting framework of your product’s ro…

GET
/item/{itemId}
Get a specific work item metadata by its ID
GetItem 2 params → 200400401403404500
DELETE
/item/{itemId}
Delete a work item
DeleteItem 1 param → 200400401403404500
GET
/item/{itemId}/flat
Get a specific work item metadata by its ID (flattened format)
GetItemFlat 2 params → 200400401403404500
GET
/workspace/{workspaceId}/items
Get all workspace working items and OKRs metadata by the workspace ID
GetItems 19 params → 200400401403500
GET
/workspace/{workspaceId}/items/flat
Get all workspace working items and OKRs metadata by the workspace ID (flattened format)
GetItemsFlat 19 params → 200400401403500
GET
/portfolio_item/{itemId}
Get a specific portfolio item metadata by its ID
GetInitiative 2 params → 200400401403404500
GET
/portfolio/{portfolioId}/items
Get all portfolio initiatives and OKRs metadata by the portfolio ID
GetInitiatives 19 params → 200400401403500
POST
/item
Create a work item
CreateItem body → 200400401403404500
PUT
/item
Update a work item
UpdateItem body → 200400401403404500

Schemas 40

The contract defines 40 schemas that model the data the API accepts and returns. The most detailed are ItemFlat (50 properties), Item (37 properties), ItemCreate (25 properties), ItemUpdate (24 properties). Each schema is shown below with its type and property counts.

NullableType_EntityId_
Persona
object
3 properties 1 required
NullableType_string-Array_
arraynull
ItemsPaginated_Initiative_
object
2 properties 2 required
EntityParent
object
4 properties 1 required
Omit_Item.workspaceId-or-initiativeId-or-sprint-or-quarter-or-assignee-or-storyPoints-or-estimatedHours-or-objective-or-keyResult-or-persona-or-personas-or-parent-or-labels-or-kano_
Construct a type with the properties of T except for those in type K.
ValidateErrorJSON
object
2 properties 2 required
Assignee
object
3 properties 2 required
CustomFieldValue
object
5 properties 1 required
PaginationMetadata
object
4 properties 4 required
ItemUpdate
object
24 properties 1 required
NullableType_Date_
stringnull
NullableType_Assignee_
EntityWithTerminology
object
3 properties
NullableType_Persona_
Item
object
37 properties
ItemCreate
object
25 properties 4 required
NullableType_EntityId-Array_
arraynull
EntityWithDates
object
4 properties
NullableType_string_
stringnull
ItemsPaginated_ItemFlat_
object
2 properties 2 required
NullableType_EntityWithDates_
Pick_Item.Exclude_keyofItem.workspaceId-or-initiativeId-or-sprint-or-quarter-or-assignee-or-storyPoints-or-estimatedHours-or-objective-or-keyResult-or-persona-or-personas-or-parent-or-labels-or-kano__
object
From T, pick a set of properties whose keys are in the union K
23 properties
Initiative
NullableType_EntityParent_
NullableType_Persona-Array_
arraynull
OutIn
object
2 properties
NullableType_Entity_
NullableType_FeedbackLink-Array_
arraynull
Entity
object
2 properties
Dependency
object
5 properties 2 required
NullableType__id_3F_3Astring.name_3F_3Astring
objectnull
2 properties
NullableType_Entity-Array_
arraynull
DevToolKeyList
object
6 properties
GeneralErrorResponse
object
1 property 1 required
ItemsPaginated_Item_
object
2 properties 2 required
ItemFlat
object
50 properties
FeedbackLink
object
5 properties
EntityId
object
1 property
NullableType_EntityWithTerminology-and-EntityWithDates_

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

craft-io-work-items-and-okrs-api-openapi.yml Raw ↑

Other APIs Craft.io publishes across the network.

Craft.io Workspace API
Craft.io Portfolio API
Craft.io Feedback Portal API
Craft.io Feedback items API
Craft.io Feedback Portals API
Craft.io Introspection API
Craft.io Portfolios API
Craft.io Workspaces API
Where this information came from

This is an independent, third-party profile of Craft.io Work Items and OKRs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.