List ideas
GET /ideas. Parameters, permissions, request and response schemas.
GET /ideas
List ideas. Requires the REST read token ability. The bearer token selects the Team; a supplied team_id cannot switch tenants. Additional role, entity-policy and plan requirements vary by operation.
Authentication
Use a team API key as Authorization: Bearer YOUR_API_KEY. The token ability and the user’s role must both allow this operation. See authentication.
{
"ability": "read",
"team": "Token-bound Team",
"authorization": "Additional role, entity-policy and plan requirements vary by operation."
}Parameters
| Name | Location | Required | Description |
|---|---|---|---|
include[] | query | No | Include[]. |
page[number] | query | No | Page number, starting at 1. |
page[size] | query | No | Results per page. Values above the configured maximum are capped. |
sort | query | No | Comma-separated sort fields; prefix a field with - for descending order. Allowed: id, state_id, custom_id, name, priority_score. |
filter[id] | query | No | Filter by id. Values use the endpoint’s configured matching; comma-separated values are supported by standard exact filters. |
filter[project_id] | query | No | Filter by project_id. Values use the endpoint’s configured matching; comma-separated values are supported by standard exact filters. |
filter[state_id] | query | No | Filter by state_id. Values use the endpoint’s configured matching; comma-separated values are supported by standard exact filters. |
filter[name] | query | No | Filter by name. Values use the endpoint’s configured matching; comma-separated values are supported by standard exact filters. |
filter[custom_id] | query | No | Filter by custom_id. Values use the endpoint’s configured matching; comma-separated values are supported by standard exact filters. |
filter[user_id] | query | No | Filter by user_id. Values use the endpoint’s configured matching; comma-separated values are supported by standard exact filters. |
include | query | No | Comma-separated relationships. Allowed: audiences, experiments, insights, metrics, pages, state, experimentsCount, insightsCount. |
include[]
{
"type": "array",
"enum": [
"audiences",
"experiments",
"insights",
"metrics",
"pages",
"state",
"ideasCount",
"experimentsCount",
"insightsCount"
],
"items": {
"type": "string",
"enum": [
"audiences",
"experiments",
"insights",
"metrics",
"pages",
"state",
"ideasCount",
"experimentsCount",
"insightsCount"
]
}
}page[number]
{
"type": "integer",
"minimum": 1,
"default": 1
}page[size]
{
"type": "integer",
"minimum": 1,
"maximum": 30,
"default": 30
}sort
{
"type": "string"
}filter[id]
{
"type": "string"
}filter[project_id]
{
"type": "string"
}filter[state_id]
{
"type": "string"
}filter[name]
{
"type": "string"
}filter[custom_id]
{
"type": "string"
}filter[user_id]
{
"type": "string"
}include
{
"type": "string"
}Example request
curl --request GET 'https://api.example.test/api/ideas' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Accept: application/json'Examples use fictional data. Replace resource IDs and the API host with your environment’s values.
Responses
200
Array of IdeaResource
Content type: application/json.
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"custom_id": {
"type": [
"string",
"null"
]
},
"numbering_scheme_id": {
"type": [
"integer",
"null"
]
},
"custom_id_number": {
"type": [
"integer",
"null"
]
},
"project_id": {
"type": [
"integer",
"null"
]
},
"state_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"hypothesis": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"integer",
"null"
]
},
"source": {
"anyOf": [
{
"type": "string",
"enum": [
"audit",
"insight",
"experiment",
"form",
"api"
],
"title": "IdeaSourceType"
},
{
"type": "null"
}
]
},
"source_id": {
"type": [
"integer",
"null"
]
},
"source_item_key": {
"type": [
"string",
"null"
]
},
"source_name": {
"type": [
"string",
"null"
]
},
"priority_values": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"priority_score": {
"type": [
"number",
"null"
]
},
"priority_details": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"priority_calculated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"state": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"project_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"color": {
"anyOf": [
{
"type": "string",
"enum": [
"gray",
"red",
"orange",
"green",
"blue",
"purple",
"rose"
],
"title": "IdeaStateColor"
},
{
"type": "null"
}
]
},
"order": {
"type": [
"integer",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"id",
"project_id",
"name",
"description",
"color",
"order",
"created_at",
"updated_at"
],
"title": "IdeaStateResource"
},
{
"type": "null"
}
]
},
"audiences": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"import_source": {
"type": [
"string",
"null"
]
},
"import_source_ref": {
"type": [
"string",
"null"
]
},
"import_source_id": {
"type": [
"string",
"null"
]
},
"data_import_id": {
"type": [
"integer",
"null"
]
},
"imported_at": {
"type": [
"string",
"null"
]
},
"project_id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"external_id": {
"type": [
"string",
"null"
]
},
"external_platform": {
"type": [
"string",
"null"
]
},
"external_synced_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"external_metadata": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"deleted_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"id",
"import_source",
"import_source_ref",
"import_source_id",
"data_import_id",
"imported_at",
"project_id",
"name",
"description",
"external_id",
"external_platform",
"external_synced_at",
"external_metadata",
"created_at",
"updated_at",
"deleted_at"
],
"title": "AudienceResource"
}
},
"experiments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"custom_id": {
"type": [
"string",
"null"
]
},
"numbering_scheme_id": {
"type": [
"integer",
"null"
]
},
"custom_id_number": {
"type": [
"integer",
"null"
]
},
"import_source": {
"type": [
"string",
"null"
]
},
"import_source_ref": {
"type": [
"string",
"null"
]
},
"import_source_id": {
"type": [
"string",
"null"
]
},
"data_import_id": {
"type": [
"integer",
"null"
]
},
"imported_at": {
"type": [
"string",
"null"
]
},
"project_id": {
"type": [
"integer",
"null"
]
},
"type": {
"anyOf": [
{
"type": "string",
"enum": [
"ab_test",
"multivariate_test"
],
"title": "ExperimentType"
},
{
"type": "null"
}
]
},
"state_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"hypothesis": {
"type": [
"string",
"null"
]
},
"primary_metric_id": {
"type": [
"integer",
"null"
]
},
"start_date": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"stop_reason": {
"anyOf": [
{
"type": "string",
"enum": [
"hypothesis_rejected",
"hypothesis_iteration",
"user_feedback",
"data_issue",
"implementation_issue",
"experiment_setup_issue",
"guardrail_metric_impact",
"secondary_metric_impact",
"operational_decision",
"performance_issue",
"testing",
"tracking_issue",
"other"
],
"title": "ExperimentStopReason"
},
{
"type": "null"
}
]
},
"result": {
"anyOf": [
{
"type": "string",
"enum": [
"conclusive_winner",
"conclusive_loser",
"inconclusive",
"error",
"other"
],
"title": "ExperimentResult"
},
{
"type": "null"
}
]
},
"decision": {
"anyOf": [
{
"type": "string",
"enum": [
"implement",
"rollout",
"retest",
"iterate",
"reject"
],
"title": "ExperimentDecision"
},
{
"type": "null"
}
]
},
"learning": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"integer",
"null"
]
},
"external_id": {
"type": [
"string",
"null"
]
},
"external_platform": {
"type": [
"string",
"null"
]
},
"external_synced_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"external_metadata": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"deleted_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"latest_approval": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"experiment_id": {
"type": "integer"
},
"user_id": {
"type": "integer"
},
"status": {
"type": "string"
},
"notes": {
"type": [
"string",
"null"
]
},
"approved_at": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"avatar": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"email",
"avatar"
]
}
},
"required": [
"id",
"experiment_id",
"user_id",
"status",
"notes",
"approved_at",
"created_at"
],
"title": "ExperimentApprovalResource"
},
{
"type": "null"
}
]
},
"approvals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"experiment_id": {
"type": "integer"
},
"user_id": {
"type": "integer"
},
"status": {
"type": "string"
},
"notes": {
"type": [
"string",
"null"
]
},
"approved_at": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"avatar": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"email",
"avatar"
]
}
},
"required": [
"id",
"experiment_id",
"user_id",
"status",
"notes",
"approved_at",
"created_at"
],
"title": "ExperimentApprovalResource"
}
}
},
"required": [
"id",
"custom_id",
"numbering_scheme_id",
"custom_id_number",
"import_source",
"import_source_ref",
"import_source_id",
"data_import_id",
"imported_at",
"project_id",
"type",
"state_id",
"name",
"description",
"hypothesis",
"primary_metric_id",
"start_date",
"end_date",
"stop_reason",
"result",
"decision",
"learning",
"user_id",
"external_id",
"external_platform",
"external_synced_at",
"external_metadata",
"created_at",
"updated_at",
"deleted_at"
],
"title": "ExperimentResource"
}
},
"insights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"custom_id": {
"type": [
"string",
"null"
]
},
"numbering_scheme_id": {
"type": [
"integer",
"null"
]
},
"custom_id_number": {
"type": [
"integer",
"null"
]
},
"import_source": {
"type": [
"string",
"null"
]
},
"import_source_ref": {
"type": [
"string",
"null"
]
},
"import_source_id": {
"type": [
"string",
"null"
]
},
"data_import_id": {
"type": [
"integer",
"null"
]
},
"imported_at": {
"type": [
"string",
"null"
]
},
"project_id": {
"type": [
"integer",
"null"
]
},
"research_collection_id": {
"type": [
"integer",
"null"
]
},
"insight_label_id": {
"type": [
"integer",
"null"
]
},
"user_id": {
"type": [
"integer",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"source_id": {
"type": [
"integer",
"null"
]
},
"source_item_key": {
"type": [
"string",
"null"
]
},
"source_label": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"deleted_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"has_ideas": {
"type": "boolean"
}
},
"required": [
"id",
"custom_id",
"numbering_scheme_id",
"custom_id_number",
"import_source",
"import_source_ref",
"import_source_id",
"data_import_id",
"imported_at",
"project_id",
"research_collection_id",
"insight_label_id",
"user_id",
"source",
"source_id",
"source_item_key",
"source_label",
"name",
"description",
"created_at",
"updated_at",
"deleted_at",
"has_ideas"
],
"title": "InsightResource"
}
},
"metrics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"import_source": {
"type": [
"string",
"null"
]
},
"import_source_ref": {
"type": [
"string",
"null"
]
},
"import_source_id": {
"type": [
"string",
"null"
]
},
"data_import_id": {
"type": [
"integer",
"null"
]
},
"imported_at": {
"type": [
"string",
"null"
]
},
"project_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"type": {
"anyOf": [
{
"type": "string",
"enum": [
"average-per-user",
"rate-per-user",
"average-per-session",
"rate-per-session"
],
"title": "MetricType"
},
{
"type": "null"
}
]
},
"winning_direction": {
"anyOf": [
{
"type": "string",
"enum": [
"increasing",
"decreasing"
],
"title": "MetricWinningDirection"
},
{
"type": "null"
}
]
},
"external_id": {
"type": [
"string",
"null"
]
},
"external_platform": {
"type": [
"string",
"null"
]
},
"external_synced_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"external_metadata": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"deleted_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"id",
"import_source",
"import_source_ref",
"import_source_id",
"data_import_id",
"imported_at",
"project_id",
"name",
"description",
"type",
"winning_direction",
"external_id",
"external_platform",
"external_synced_at",
"external_metadata",
"created_at",
"updated_at",
"deleted_at"
],
"title": "MetricResource"
}
},
"pages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"import_source": {
"type": [
"string",
"null"
]
},
"import_source_ref": {
"type": [
"string",
"null"
]
},
"import_source_id": {
"type": [
"string",
"null"
]
},
"data_import_id": {
"type": [
"integer",
"null"
]
},
"imported_at": {
"type": [
"string",
"null"
]
},
"project_id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"external_id": {
"type": [
"string",
"null"
]
},
"external_platform": {
"type": [
"string",
"null"
]
},
"external_synced_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"external_metadata": {
"description": "JSON object or array. Object keys depend on the provider, form question, or configuration being stored.",
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "array",
"items": {
"description": "An arbitrary JSON value retained by a metadata/settings field.",
"oneOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/JsonValue"
}
},
{
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
}
}
]
}
},
{
"type": "null"
}
]
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"deleted_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"id",
"import_source",
"import_source_ref",
"import_source_id",
"data_import_id",
"imported_at",
"project_id",
"name",
"description",
"external_id",
"external_platform",
"external_synced_at",
"external_metadata",
"created_at",
"updated_at",
"deleted_at"
],
"title": "PageResource"
}
},
"experiments_count": {
"type": "integer"
},
"insights_count": {
"type": "integer"
}
},
"required": [
"id",
"custom_id",
"numbering_scheme_id",
"custom_id_number",
"project_id",
"state_id",
"name",
"description",
"hypothesis",
"user_id",
"source",
"source_id",
"source_item_key",
"source_name",
"priority_values",
"priority_score",
"priority_details",
"priority_calculated_at",
"created_at",
"updated_at"
],
"title": "IdeaResource"
}
},
"links": {
"type": "object",
"properties": {
"first": {
"type": [
"string",
"null"
]
},
"last": {
"type": [
"string",
"null"
]
},
"prev": {
"type": [
"string",
"null"
]
},
"next": {
"type": [
"string",
"null"
]
}
},
"required": [
"first",
"last",
"prev",
"next"
]
},
"meta": {
"type": "object",
"properties": {
"current_page": {
"type": "integer",
"minimum": 1
},
"from": {
"type": [
"integer",
"null"
],
"minimum": 1
},
"last_page": {
"type": "integer",
"minimum": 1
},
"links": {
"type": "array",
"description": "Generated paginator links.",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"label": {
"type": "string"
},
"active": {
"type": "boolean"
}
},
"required": [
"url",
"label",
"active"
]
}
},
"path": {
"type": [
"string",
"null"
],
"description": "Base path for paginator generated URLs."
},
"per_page": {
"type": "integer",
"description": "Number of items shown per page.",
"minimum": 0
},
"to": {
"type": [
"integer",
"null"
],
"description": "Number of the last item in the slice.",
"minimum": 1
},
"total": {
"type": "integer",
"description": "Total number of items being paginated.",
"minimum": 0
}
},
"required": [
"current_page",
"from",
"last_page",
"links",
"path",
"per_page",
"to",
"total"
]
}
},
"required": [
"data",
"links",
"meta"
]
}{
"data": [
{
"id": 101,
"custom_id": null,
"numbering_scheme_id": null,
"custom_id_number": null,
"project_id": null,
"state_id": null,
"name": "Checkout delivery estimate",
"description": null,
"hypothesis": null,
"user_id": null,
"source": null,
"source_id": null,
"source_item_key": null,
"source_name": null,
"priority_values": null,
"priority_score": null,
"priority_details": null,
"priority_calculated_at": null,
"created_at": null,
"updated_at": null
}
],
"links": {
"first": null,
"last": null,
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": null,
"last_page": 1,
"links": [
{
"url": null,
"label": "example",
"active": true
}
],
"path": null,
"per_page": 1,
"to": null,
"total": 1
}
}400
Unsupported filter, sort, or include.
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Requested query option is not allowed."
}
},
"required": [
"message"
]
}{
"message": "Requested query option is not allowed."
}401
Unauthenticated
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Error overview."
}
},
"required": [
"message"
]
}{
"message": "The request could not be completed."
}403
Authorization error
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Error overview."
}
},
"required": [
"message"
]
}{
"message": "The request could not be completed."
}422
Validation error
Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Errors overview."
},
"errors": {
"type": "object",
"description": "A detailed description of each field that failed validation.",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"required": [
"message",
"errors"
]
}{
"message": "The request could not be completed.",
"errors": {
"name": [
"The name field is required."
]
}
}429
Rate limit exceeded. Honor Retry-After before retrying.
Response headers:
{
"Retry-After": {
"description": "Seconds before retrying.",
"schema": {
"type": "integer"
}
}
}Content type: application/json.
{
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Too Many Attempts."
}
},
"required": [
"message"
]
}{
"message": "Too Many Attempts."
}See API conventions for error handling, rate limits, pagination, and uploads.