Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mavenlink-daily-scheduled-hours-story-allocation-days-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: 1.0.0
title: Kantata OX API Documentation Daily Scheduled Hours (Story…
description: Kantata OX's API provides access to the majority of Kantata OX's data model.
termsOfService: https://www.kantata.com/terms-of-use
contact:
name: Kantata OX Support
url: https://knowledge.kantata.com/hc/en-us
license:
name: COPYRIGHT © 2026 Kantata, Inc.
url: https://www.kantata.com/terms-of-use
x-logo:
url: https://theme.zdassets.com/theme_assets/56104/04e93064d309f75d054b8cee885d1ea51e9be8f7.png
backgroundColor: '#FFFFFF'
altText: Kantata OX API Documentation
href: https://developer.kantata.com
servers:
- url: https://api.mavenlink.com/api/v1
tags:
- name: Daily Scheduled Hours (Story Allocation Days)
description: 'Daily Scheduled Hours (also called Story Allocation Days) is the allocation of time for a resource to
spend on a specific task, on a specific day.
Daily Scheduled Hours are part of Assignments,
so if an Assignment is deleted, so are its Daily Scheduled Hours.'
paths:
/story_allocation_days:
get:
summary: Fetching a list of Daily Scheduled Hours (Story Allocation Days)
description: 'Returns all Daily Scheduled Hours that are visible to the requester,
based on permissions. Filter results by specific projects, users, tasks, and more.
**NOTES**:
- The response includes Daily Scheduled Hours that are part of inactive Assignments, by default.
To filter these out, use the `current` parameter.
- If you are an Account Administrator, you can use the `only_my_account` parameter to filter for
Daily Scheduled Hours from only your account. This optimizes performance of the endpoint.
The returned Daily Scheduled Hours are sorted by when they were last updated.
This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `story_allocation_days` top-level JSON key.
Please see our Response Format section for more information.'
operationId: Get Story Allocation Days
tags:
- Daily Scheduled Hours (Story Allocation Days)
parameters:
- in: query
name: assignee_id
description: Returns Daily Scheduled Hours that are assigned to the User of the specified ID.
schema:
type: integer
format: int32
- in: query
name: assignment_id
description: Returns Daily Scheduled Hours that belong to the Assignment of the specified ID.
schema:
type: integer
format: int32
- in: query
name: created_after
description: Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
schema:
type: string
format: date-time
- in: query
name: created_before
description: Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
schema:
type: string
format: date-time
- in: query
name: current
description: Returns Daily Scheduled Hours that belong to active Assignments.
schema:
type: boolean
- in: query
name: date_between
description: Requires a colon separated pair of dates in YYYY-MM-DD format. Results are inclusive of the endpoints. If a date is not passed in, it is interpreted as negative or positive infinity.
schema:
type: string
- in: query
name: external_reference_external_message
description: Filter the objects based on the external message of their associated external references. This is an exact match.
schema:
type: string
- in: query
name: external_reference_external_status
description: Filter by the status of the external object in the external system.
schema:
type: string
- in: query
name: external_reference_service_model
description: Filter by the type of the external object this external reference belongs to.
schema:
type: string
- in: query
name: external_reference_service_model_ref
description: Filter by the id of the external object this external reference belongs to.
schema:
type: integer
format: int32
- in: query
name: external_reference_service_model_refs
description: Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.
schema:
type: string
- in: query
name: external_reference_service_name
description: Filter by the name of the provider for integration.
schema:
type: string
- in: query
name: external_reference_status
description: Filter by the status of the integration, this can be successful or fail.
schema:
type: string
- in: query
name: has_external_references
description: Filter by whether or not the object has external references.
schema:
type: boolean
- in: query
name: in_unarchived_stories
description: Returns Daily Scheduled Hours that belong to active (not archived) Stories.
schema:
type: boolean
default: true
- in: query
name: in_unarchived_workspaces
description: Returns Daily Scheduled Hours that belong to active (not archived) Workspaces.
schema:
type: boolean
default: true
- in: query
name: include
description: 'Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.
- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.
- `external_references` (ExternalReference) - Includes references to external integrations for this object.
- `story` (Story) - Reference the Story of the Story Allocation Day.
- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.'
schema:
type: string
- in: query
name: include_unnamed
required: false
description: 'Includes Daily Scheduled Hours from Assignments with
[unnamed resources](https://mavenlink.zendesk.com/hc/en-us/articles/115004696493#Unnamed).
Think of unnamed resources as placeholders; it indicates the need for a certain role,
before knowing who will fill it.
Set to `False` by default.'
schema:
type: boolean
default: false
- in: query
name: only
description: 'Allows you to request one or more resources directly by ID. Multiple IDs can be supplied
in a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.'
schema:
type: string
- in: query
name: only_my_account
required: false
description: 'If you are an Account Administrator, you can set this to `True` in order to filter
for Daily Scheduled Hours from only your account.
Enabling this filter optimizes performance of the endpoint.
The filter is set to `False` by default.'
schema:
type: boolean
default: false
- in: query
name: order
description: 'Supply `order` with the name of a valid sort field for the endpoint and a direction.
Valid values: `created_at:asc`, `created_at:desc`, `date:asc`, `date:desc`, `id:asc`, `id:desc`, `updated_at:asc`, and `updated_at:desc`.'
schema:
type: string
default: updated_at:desc
- in: query
name: page
schema:
type: integer
format: int32
default: 1
- in: query
name: per_page
schema:
type: integer
format: int32
default: 20
maximum: 200
- in: query
name: story_id
description: Returns Daily Scheduled Hours that belong to the Story of the specified ID.
schema:
type: integer
format: int32
- in: query
name: uncurrent
description: Returns Daily Scheduled Hours that belong to inactive Assignments.
schema:
type: boolean
- in: query
name: updated_after
description: Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
schema:
type: string
format: date-time
- in: query
name: updated_at_between
description: Requires a colon separated pair of timestamps. Timestamps are in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) with colons removed. Results are inclusive of the endpoints. If a timestamp is not passed in, it is interpreted as negative or positive infinity.
schema:
type: string
- in: query
name: updated_before
description: Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
schema:
type: string
format: date-time
- in: query
name: without_external_reference_service_name
description: Exclude by the existence of an external reference with the specified service name.
schema:
type: string
- in: query
name: workspace_id
description: Returns Daily Scheduled Hours that belong to the Workspace of the specified ID.
schema:
type: integer
format: int32
responses:
'200':
description: A list of Daily Scheduled Hours (Story Allocation Day)s have been retrieved.
content:
application/json:
schema:
type: object
properties:
count:
type: integer
format: int32
meta:
type: object
properties:
count:
type: integer
format: int32
page_count:
type: integer
format: int32
page_number:
type: integer
format: int32
page_size:
type: integer
format: int32
results:
type: array
items:
type: object
properties:
key:
type: string
id:
type: string
story_allocation_days:
type: object
additionalProperties:
$ref: '#/components/schemas/StoryAllocationDay'
external_references:
type: object
additionalProperties:
$ref: '#/components/schemas/ExternalReference'
assignments:
type: object
additionalProperties:
$ref: '#/components/schemas/Assignment'
stories:
type: object
additionalProperties:
$ref: '#/components/schemas/Story'
workspaces:
type: object
additionalProperties:
$ref: '#/components/schemas/Workspace'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Page Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Service is unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
post:
summary: Creating a new Daily Scheduled Hours (Story Allocation Day)
description: 'This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `story_allocation_days` top-level JSON key.
Please see our Response Format section for more information.'
operationId: Create Story Allocation Day
tags:
- Daily Scheduled Hours (Story Allocation Days)
parameters:
- in: query
name: include
description: 'Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.
- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.
- `external_references` (ExternalReference) - Includes references to external integrations for this object.
- `story` (Story) - Reference the Story of the Story Allocation Day.
- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.'
schema:
type: string
responses:
'200':
description: Daily Scheduled Hours (Story Allocation Day) has been created.
content:
application/json:
schema:
type: object
properties:
count:
type: integer
format: int32
meta:
type: object
properties:
count:
type: integer
format: int32
page_count:
type: integer
format: int32
page_number:
type: integer
format: int32
page_size:
type: integer
format: int32
results:
type: array
items:
type: object
properties:
key:
type: string
id:
type: string
story_allocation_days:
type: object
additionalProperties:
$ref: '#/components/schemas/StoryAllocationDay'
external_references:
type: object
additionalProperties:
$ref: '#/components/schemas/ExternalReference'
assignments:
type: object
additionalProperties:
$ref: '#/components/schemas/Assignment'
stories:
type: object
additionalProperties:
$ref: '#/components/schemas/Story'
workspaces:
type: object
additionalProperties:
$ref: '#/components/schemas/Workspace'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Page Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Service is unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
type: object
properties:
story_allocation_day:
type: object
properties:
assignment_id:
type: integer
format: int32
description: The ID of the Assignment the Daily Scheduled Hours are part of.
date:
type: string
format: date
description: The date of the scheduled hours (e.g. 2014-12-31). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
minutes:
type: integer
format: int32
description: "The amount of time scheduled for the day, in minutes\n (e.g. `120` for 120 minutes, which is 2 hours)."
external_reference:
type: object
description: 'Typically populated programmatically by a third party system via an integration, this is an optional
object that holds data from an external system. It connects objects in an external system with objects in
Kantata OX (for example, to connect a Jira issue to a Kantata OX Project).'
properties:
service_name:
type: string
description: The provider name of the integration. If you are adding multiple external references to the same object, the `service_name` must be unique.
service_model:
type: string
description: The object type of the external object this external reference belongs to.
service_model_ref:
type: string
description: The object ID of the external object this external reference belongs to.
status:
type: string
description: The status of the integration. Options are `successful`, `pending`, or `failed`.
external_message:
type: string
description: The message on the external object.
external_link:
type: string
description: The link to the external object.
external_status:
type: string
description: The status of the external object in the external system.
locked:
type: boolean
description: Whether the subject is locked.
required:
- service_name
- service_model
- service_model_ref
required:
- assignment_id
- date
- minutes
required: true
delete:
summary: Delete multiple Daily Scheduled Hours (Story Allocation Days)
description: 'The IDs of the Daily Scheduled Hours to delete can be provided in the `ids` query parameter or
via the request body. Only daily scheduled hours on your account can be deleted.
Request body example:
```{
"ids": "1,2,3"
}```
If any specified Daily Scheduled Hours cannot be deleted, the entire request will fail and an error message
will be returned that specifies which ones could not be deleted and why.
This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `story_allocation_days` top-level JSON key.
Please see our Response Format section for more information.'
operationId: Delete Story Allocation Days
tags:
- Daily Scheduled Hours (Story Allocation Days)
parameters:
- in: query
name: ids
required: false
description: 'A comma-separated list of IDs of Daily Scheduled Hours. You can provide up to 100 IDs. The IDs can be
provided in this query parameter or via the request body.'
schema:
type: string
responses:
'204':
description: Daily Scheduled Hours (Story Allocation Day) has been deleted.
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Page Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Service is unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
/story_allocation_days/{id}:
get:
summary: Fetching a single Daily Scheduled Hours (Story Allocation Day)
description: 'This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `story_allocation_days` top-level JSON key.
Please see our Response Format section for more information.'
operationId: Get Story Allocation Day
tags:
- Daily Scheduled Hours (Story Allocation Days)
parameters:
- in: path
name: id
required: true
description: The ID of the Model.
schema:
type: integer
- in: query
name: include
description: 'Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.
- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.
- `external_references` (ExternalReference) - Includes references to external integrations for this object.
- `story` (Story) - Reference the Story of the Story Allocation Day.
- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.'
schema:
type: string
responses:
'200':
description: The Daily Scheduled Hours (Story Allocation Day) has been retrieved.
content:
application/json:
schema:
type: object
properties:
count:
type: integer
format: int32
meta:
type: object
properties:
count:
type: integer
format: int32
page_count:
type: integer
format: int32
page_number:
type: integer
format: int32
page_size:
type: integer
format: int32
results:
type: array
items:
type: object
properties:
key:
type: string
id:
type: string
story_allocation_days:
type: object
additionalProperties:
$ref: '#/components/schemas/StoryAllocationDay'
external_references:
type: object
additionalProperties:
$ref: '#/components/schemas/ExternalReference'
assignments:
type: object
additionalProperties:
$ref: '#/components/schemas/Assignment'
stories:
type: object
additionalProperties:
$ref: '#/components/schemas/Story'
workspaces:
type: object
additionalProperties:
$ref: '#/components/schemas/Workspace'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Page Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Service is unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
put:
summary: Updating an existing Daily Scheduled Hours (Story Allocation Day)
description: 'This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `story_allocation_days` top-level JSON key.
Please see our Response Format section for more information.'
operationId: Update Story Allocation Day
tags:
- Daily Scheduled Hours (Story Allocation Days)
parameters:
- in: path
name: id
required: true
description: The ID of the Model.
schema:
type: integer
- in: query
name: include
description: 'Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.
- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.
- `external_references` (ExternalReference) - Includes references to external integrations for this object.
- `story` (Story) - Reference the Story of the Story Allocation Day.
- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.'
schema:
type: string
responses:
'200':
description: Daily Scheduled Hours (Story Allocation Day) has been updated.
content:
application/json:
schema:
type: object
properties:
count:
type: integer
format: int32
meta:
type: object
properties:
count:
type: integer
format: int32
page_count:
type: integer
format: int32
page_number:
type: integer
format: int32
page_size:
type: integer
format: int32
results:
type: array
items:
type: object
properties:
key:
type: string
id:
type: string
story_allocation_days:
type: object
additionalProperties:
$ref: '#/components/schemas/StoryAllocationDay'
external_references:
type: object
additionalProperties:
$ref: '#/components/schemas/ExternalReference'
assignments:
type: object
additionalProperties:
$ref: '#/components/schemas/Assignment'
stories:
type: object
additionalProperties:
$ref: '#/components/schemas/Story'
workspaces:
type: object
additionalProperties:
$ref: '#/components/schemas/Workspace'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Page Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Service is unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
type: object
properties:
story_allocation_day:
type: object
properties:
minutes:
type: integer
format: int32
description: "The amount of time scheduled for the day, in minutes\n (e.g. `120` for 120 minutes, which is 2 hours)."
external_reference:
type: object
# --- truncated at 32 KB (88 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mavenlink/refs/heads/main/openapi/mavenlink-daily-scheduled-hours-story-allocation-days-api-openapi.yml