Puzzle Tasks API
The Tasks API from Puzzle — 2 operation(s) for tasks.
Work with this as data
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/puzzle-tasks-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 Specification
openapi: 3.2.0
info:
title: Puzzle Tasks API
description: Puzzle Api
version: '0'
servers:
- url: https://staging.southparkdata.com/rest/v0
tags:
- name: Tasks
paths:
/company/{id}/tasks:
get:
operationId: tasks
summary: Get Tasks
description: 'This endpoint is experimental and is subject to change
Retrieves a list of tasks for the company. Tasks represent work items that need to be completed, such as categorization reviews, documentation requests, or messages.
Required scope: read:company'
tags:
- Tasks
parameters:
- name: id
in: path
required: true
description: The company ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
- name: status
in: query
required: false
schema:
anyOf:
- type: string
- type: array
items:
type: string
- name: type
in: query
required: false
schema:
anyOf:
- type: string
- type: array
items:
type: string
- name: assigneeIds
in: query
required: false
schema:
anyOf:
- type: string
minLength: 1
description: Partner-facing external identifier
- type: array
items:
type: string
minLength: 1
description: Partner-facing external identifier
- name: transactionIds
in: query
required: false
schema:
anyOf:
- type: string
minLength: 1
description: Partner-facing external identifier
- type: array
items:
type: string
minLength: 1
description: Partner-facing external identifier
- name: createdBy
in: query
required: false
schema:
type: string
minLength: 1
description: Partner-facing external identifier
- name: createdAfter
in: query
required: false
schema:
type: string
minLength: 1
description: ISO 8601 timestamp
- name: count
in: query
required: false
schema:
type: integer
- name: after
in: query
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
type: object
properties:
id:
type: string
minLength: 1
description: Partner-facing external identifier
companyId:
type: string
minLength: 1
description: Partner-facing external identifier
type:
type: string
enum:
- CategoryReview
- Documentation
- Message
status:
type: string
enum:
- Open
- Completed
- Cancelled
transactionId:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
createdBy:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
modifiedBy:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
assignees:
type:
- array
- 'null'
items:
type: string
minLength: 1
description: Partner-facing external identifier
text:
type:
- string
- 'null'
required:
- id
- companyId
- type
- status
- transactionId
- createdBy
- modifiedBy
- assignees
- text
pageInfo:
type: object
properties:
endCursor:
type:
- string
- 'null'
hasNextPage:
type: boolean
total:
type:
- integer
- 'null'
required:
- endCursor
- hasNextPage
- total
required:
- items
- pageInfo
post:
operationId: createTask
summary: Create Task
description: 'This endpoint is experimental and is subject to change
Click here for more information.
Create a task for the given company.
Required scope: write:task'
tags:
- Tasks
parameters:
- name: id
in: path
required: true
description: The company ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
type:
type: string
enum:
- CategoryReview
- Documentation
- Message
transactionId:
type: string
minLength: 1
description: Partner-facing external identifier
assignees:
type: array
items:
type: string
minLength: 1
description: Partner-facing external identifier
text:
type: string
required:
- type
- transactionId
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
minLength: 1
description: Partner-facing external identifier
companyId:
type: string
minLength: 1
description: Partner-facing external identifier
type:
type: string
enum:
- CategoryReview
- Documentation
- Message
status:
type: string
enum:
- Open
- Completed
- Cancelled
transactionId:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
createdBy:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
modifiedBy:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
assignees:
type:
- array
- 'null'
items:
type: string
minLength: 1
description: Partner-facing external identifier
text:
type:
- string
- 'null'
createdAt:
type: string
minLength: 1
description: ISO 8601 timestamp
updatedAt:
type: string
minLength: 1
description: ISO 8601 timestamp
required:
- id
- companyId
- type
- status
- transactionId
- createdBy
- modifiedBy
- assignees
- text
- createdAt
- updatedAt
/company/{id}/tasks/{taskId}:
patch:
operationId: updateTask
summary: Update Task
description: 'This endpoint is experimental and is subject to change
Click here for more information.
Update a task for the given company.
Required scope: write:task'
tags:
- Tasks
parameters:
- name: id
in: path
required: true
description: The company ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
- name: taskId
in: path
required: true
description: The task ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- Open
- Completed
- Cancelled
assignees:
type: array
items:
type: string
minLength: 1
description: Partner-facing external identifier
text:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
minLength: 1
description: Partner-facing external identifier
companyId:
type: string
minLength: 1
description: Partner-facing external identifier
type:
type: string
enum:
- CategoryReview
- Documentation
- Message
status:
type: string
enum:
- Open
- Completed
- Cancelled
transactionId:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
createdBy:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
modifiedBy:
type:
- string
- 'null'
minLength: 1
description: Partner-facing external identifier
assignees:
type:
- array
- 'null'
items:
type: string
minLength: 1
description: Partner-facing external identifier
text:
type:
- string
- 'null'
required:
- id
- companyId
- type
- status
- transactionId
- createdBy
- modifiedBy
- assignees
- text