Mosey Tasks API
The Tasks API from Mosey — 9 operation(s) for tasks.
The Tasks API from Mosey — 9 operation(s) for tasks.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mosey-tasks-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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:
title: Mosey Accounts Tasks API
description: If you'd like to use the Mosey API, please contact sales@mosey.com.
version: 1.0.0
x-logo:
url: null
servers:
- url: https://api.mosey.com
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Tasks
paths:
/v2/tasks:
get:
summary: List Mosey Tasks
operationId: List_Mosey_Tasks_v2_tasks_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/PlatformTask'
type: array
title: Response List Mosey Tasks V2 Tasks Get
security:
- OAuth2PasswordBearer: []
- OAuth2PasswordBearer: []
tags:
- Tasks
/tasks:
get:
summary: List Tasks
description: Returns a list of tasks relevant for the authenticated legal entity. Tasks are sorted algorithmically by importance. To filter by status include a `status` parameter for each status you wish to be included in the response.
operationId: list_tasks_handler_tasks_get
security:
- OAuth2PasswordBearer: []
- OAuth2PasswordBearer: []
parameters:
- name: definition_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Definition Id
- name: start_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
title: Start Date
- name: end_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
title: End Date
- name: include_managed
in: query
required: false
schema:
anyOf:
- type: boolean
- type: 'null'
default: false
title: Include Managed
- name: status
in: query
required: false
schema:
anyOf:
- type: array
items:
$ref: '#/components/schemas/AccountTaskStatus'
- type: 'null'
title: Status
- name: tags
in: query
required: false
schema:
anyOf:
- type: array
items:
$ref: '#/components/schemas/AccountTaskTag'
- type: 'null'
description: Tags are filtering criteria for tasks. When multiple tags are passed, tasks associated with at least one of the tags are returned.
title: Tags
description: Tags are filtering criteria for tasks. When multiple tags are passed, tasks associated with at least one of the tags are returned.
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/AccountTask'
title: Response List Tasks Handler Tasks Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Tasks
/tasks/{task_id}:
get:
summary: Get Task
description: Returns the specified task.
operationId: get_task_handler_tasks__task_id__get
security:
- OAuth2PasswordBearer: []
- OAuth2PasswordBearer: []
parameters:
- name: task_id
in: path
required: true
schema:
type: string
title: Task Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccountTask'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Tasks
patch:
summary: Update Task Status
description: Updates the status for the specified task. Returns the updated task.
operationId: patch_task_handler_tasks__task_id__patch
security:
- OAuth2PasswordBearer: []
- OAuth2PasswordBearer: []
parameters:
- name: task_id
in: path
required: true
schema:
type: string
title: Task Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AccountTaskUpdateStatus'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccountTask'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Tasks
/tasks/{task_id}/automate/sessions:
post:
summary: Create Hosted Session to Automate Task
description: Starts the Mosey automation for the task. If the automation requires input from the user, the response will include a URL that will redirect them to a form to collect it.
operationId: automate_task_handler_tasks__task_id__automate_sessions_post
security:
- OAuth2PasswordBearer: []
- OAuth2PasswordBearer: []
parameters:
- name: task_id
in: path
required: true
schema:
type: string
title: Task Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AutomationSessionRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AutomationSessionResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Tasks
/tasks/sessions:
post:
summary: Create Hosted Session to View Tasks
description: Returns a URL with session, where the tasks are hosted at Mosey. Users can filter tasks based on location and status. Users can also act on these tasks
operationId: hosted_task_tasks_sessions_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TasksSessionRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TasksSessionResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- OAuth2PasswordBearer: []
- OAuth2PasswordBearer: []
tags:
- Tasks
/v2/tasks/{task_id}:
get:
summary: Get Task
operationId: Get_Task_v2_tasks__task_id__get
security:
- OAuth2PasswordBearer: []
parameters:
- name: task_id
in: path
required: true
schema:
type: string
title: Task Id
- name: legal_entity_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Legal Entity Public Id
- name: user_or_platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User Or Platform Public Id
- name: platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Platform Public Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformTask_2'
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformHttpException'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Tasks
patch:
summary: Update Task Status
description: 'Updates the status of the specified requirement task.
Question task''s status cannot be updated.
Task status can be updated to todo or done only.
After a successful update, the updated task is returned.'
operationId: patch_task_handler_v2_tasks__task_id__patch
security:
- OAuth2PasswordBearer: []
parameters:
- name: task_id
in: path
required: true
schema:
type: string
title: Task Id
- name: legal_entity_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Legal Entity Public Id
- name: user_or_platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User Or Platform Public Id
- name: platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Platform Public Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformTaskUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformUpdateTaskStatusResponse'
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformHttpException'
description: Unprocessable Entity
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformHttpException'
description: Not Found
tags:
- Tasks
/v2/tasks/questions/{question_task_id}:
patch:
summary: Update Question Task Answer
description: 'Answer a question task.
A question could accept a boolean (true/false) answer or numerical answer or a date
After a successful update, the task''s status is returned.'
operationId: patch_question_task_handler_v2_tasks_questions__question_task_id__patch
security:
- OAuth2PasswordBearer: []
parameters:
- name: question_task_id
in: path
required: true
schema:
type: string
title: Question Task Id
- name: legal_entity_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Legal Entity Public Id
- name: user_or_platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User Or Platform Public Id
- name: platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Platform Public Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformQuestionTaskUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformUpdateQuestionTaskStatusResponse'
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformHttpException'
description: Unprocessable Entity
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformHttpException'
description: Not Found
tags:
- Tasks
/v2/tasks/manage/session:
post:
summary: Create Tasks Management Session
description: 'Creates an authenticated session to enter the Mosey app, and returns
the url on which a user can view and manage tasks.
The tasks shown are dictated by the values provided in the request:
`task_type` and optionally `status`.
When requesting question tasks, only `todo` and `done` statuses
can be requested.'
operationId: Create_Tasks_Management_Session_v2_tasks_manage_session_post
security:
- OAuth2PasswordBearer: []
parameters:
- name: legal_entity_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Legal Entity Public Id
- name: user_or_platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User Or Platform Public Id
- name: platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Platform Public Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/HostedManageTasksSessionRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/HostedSessionResponse'
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformHttpException'
description: Unprocessable Entity
tags:
- Tasks
/v2/tasks/{task_id}/session:
post:
summary: Create A Task Resolution Session
operationId: Create_a_Task_Resolution_Session_v2_tasks__task_id__session_post
security:
- OAuth2PasswordBearer: []
parameters:
- name: task_id
in: path
required: true
schema:
type: string
title: Task Id
- name: legal_entity_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Legal Entity Public Id
- name: user_or_platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: User Or Platform Public Id
- name: platform_public_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Platform Public Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/HostedSessionRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/HostedSessionResponse'
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformHttpException'
description: Not Found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Tasks
components:
schemas:
AccountTaskResolutionAutomate:
properties:
type:
type: string
const: automate
title: Type
default: automate
form_spec:
$ref: '#/components/schemas/AccountTaskAutomationFormSpec'
submit_url:
type: string
title: Submit Url
hosted_url:
type: string
title: Hosted Url
type: object
required:
- form_spec
- submit_url
- hosted_url
title: AccountTaskResolutionAutomate
ActionField:
properties:
name:
type: string
title: Name
description:
type: string
title: Description
required:
type: boolean
title: Required
type:
type: string
title: Type
type: object
required:
- name
- description
- required
- type
title: ActionField
AccountTaskDefinition:
properties:
id:
type: string
title: Id
title:
type: string
title: Title
summary:
anyOf:
- type: string
- type: 'null'
title: Summary
description:
type: string
title: Description
type:
$ref: '#/components/schemas/TaskDefinitionType'
resources:
items:
additionalProperties:
type: string
type: object
type: array
title: Resources
location:
$ref: '#/components/schemas/LocationRef'
type: object
required:
- id
- title
- description
- type
- resources
- location
title: AccountTaskDefinition
TaskCategory:
type: string
enum:
- hr
- insurance
- payroll
- registration
- registration-maintenance
- tax
- sales-tax
title: TaskCategory
TagInstance:
type: string
enum:
- certificate-of-good-standing
- charity-registration
- charity-registration-renewal
- employee-final-wage-payment
- employee-new-hire-reporting
- employee-onboarding
- employee-termination
- employee-requirement
- exemption
- foreign-qualification
- foreign-state-only
- handbook
- home-state-only
- initial-statement
- local-business-exemption-setup
- local-business-setup
- local-business-registration-renewal
- local-business-tax-setup
- local-payroll-setup
- newspaper-publication
- notices
- payroll-setup
- registered-agent
- sos-report
- check-account-logins
- setup
- tpa-setup
- task-applicability-override
- sales-tax
- warn-notice
- password-update
- mail-delivery
title: TagInstance
PlatformTaskType:
type: string
enum:
- requirement
- question
title: PlatformTaskType
AccountTaskUpdateStatus:
properties:
status:
$ref: '#/components/schemas/AccountTaskStatus'
type: object
required:
- status
title: AccountTaskUpdateStatus
PlatformTaskResolutionEndpoint:
properties:
type:
type: string
const: endpoint
title: Type
default: endpoint
description:
type: string
title: Description
method:
type: string
title: Method
url:
type: string
title: Url
content_type:
type: string
title: Content Type
fields:
items:
$ref: '#/components/schemas/ActionField'
type: array
title: Fields
type: object
required:
- description
- method
- url
- content_type
- fields
title: PlatformTaskResolutionEndpoint
description: Directs a user to take action in order to resolve the task using an API endpoint.
TasksSessionRequest:
properties:
callback_url:
type: string
title: Callback Url
type: object
required:
- callback_url
title: TasksSessionRequest
AccountTaskResolutionManualStep:
properties:
id:
type: string
title: Id
title:
type: string
title: Title
description:
type: string
title: Description
paths:
items:
$ref: '#/components/schemas/AccountTaskResolutionManualStepPath'
type: array
title: Paths
order:
type: integer
title: Order
type: object
required:
- id
- title
- description
- paths
- order
title: AccountTaskResolutionManualStep
PlatformTaskUnlocks:
properties:
requirement_id:
type: string
title: Requirement Id
title:
type: string
title: Title
definition:
type: string
title: Definition
summary:
anyOf:
- type: string
- type: 'null'
title: Summary
resources:
items:
additionalProperties:
type: string
type: object
type: array
title: Resources
region:
$ref: '#/components/schemas/RegionRef'
tags:
anyOf:
- items:
$ref: '#/components/schemas/TagInstance'
type: array
- type: 'null'
title: Tags
source:
type: string
const: requirement
title: Source
default: requirement
type: object
required:
- requirement_id
- title
- definition
- resources
- region
title: PlatformTaskUnlocks
AccountTaskAutomationFormSpec:
properties: {}
type: object
title: AccountTaskAutomationFormSpec
PlatformTaskResolutionManualStep:
properties:
id:
type: string
title: Id
title:
type: string
title: Title
description:
type: string
title: Description
paths:
items:
$ref: '#/components/schemas/PlatformTaskResolutionManualStepPath'
type: array
title: Paths
order:
type: integer
title: Order
type: object
required:
- id
- title
- description
- paths
- order
title: PlatformTaskResolutionManualStep
LocationScope:
type: string
enum:
- entity
- region
- zip
- city
title: LocationScope
LocationRef:
properties:
id:
type: string
title: Id
code:
type: string
title: Code
name:
type: string
title: Name
type: object
required:
- id
- code
- name
title: LocationRef
PlatformHttpException:
properties:
message:
type: string
title: Message
detail:
type: string
title: Detail
type: object
required:
- message
- detail
title: PlatformHttpException
PlatformTaskQuestionResolutions:
properties:
hosted:
anyOf:
- $ref: '#/components/schemas/PlatformTaskResolutionHosted'
- type: 'null'
endpoint:
anyOf:
- $ref: '#/components/schemas/PlatformTaskResolutionEndpoint'
- type: 'null'
type: object
title: PlatformTaskQuestionResolutions
FeeRange:
properties:
type:
type: string
const: range
title: Type
default: range
min:
type: string
title: Min
max:
type: string
title: Max
type: object
required:
- min
- max
title: FeeRange
AccountTaskStatus:
type: string
enum:
- todo
- dismissed
- in-progress
- done
title: AccountTaskStatus
AccountTaskEstimation:
properties:
min:
type: integer
title: Min
max:
type: integer
title: Max
unit:
$ref: '#/components/schemas/ETAUnit'
type: object
required:
- min
- max
- unit
title: AccountTaskEstimation
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
AccountManagedProvider:
properties:
id:
type: string
title: Id
name:
type: string
title: Name
type: object
required:
- id
- name
title: AccountManagedProvider
PlatformAgencyAttributeStatus:
type: string
enum:
- todo
- in-progress
- done
title: PlatformAgencyAttributeStatus
PlatformTaskResolutionManualStepPath:
properties:
type:
type: string
title: Type
value:
type: string
title: Value
text:
anyOf:
- type: string
- type: 'null'
title: Text
type: object
required:
- type
- value
title: PlatformTaskResolutionManualStepPath
PlatformQuestionTaskUpdate:
properties:
answer:
anyOf:
- type: integer
- type: boolean
- type: string
format: date
- type: number
title: Answer
type: object
required:
- answer
title: PlatformQuestionTaskUpdate
AccountTaskResolutionRedirect:
properties:
type:
type: string
const: redirect
title: Type
default: redirect
url:
type: string
title: Url
type: object
required:
- url
title: AccountTaskResolutionRedirect
PlatformTaskStatusUpdate:
type: string
enum:
- todo
- done
title: PlatformTaskStatusUpdate
ETAUnit:
type: string
enum:
- hour
- day
- week
- month
title: ETAUnit
PlatformTaskStatus:
type: string
enum:
- todo
- deferred
- in-progress
- done
title: PlatformTaskStatus
StateCode:
type: string
enum:
- AL
- AK
- AZ
- AR
- CA
- CO
- CT
- DE
- DC
- FL
- GA
- HI
- ID
- IL
- IN
- IA
- KS
- KY
- LA
- ME
- MD
- MA
- MI
- MN
- MS
- MO
- MT
- NE
- NV
- NH
- NJ
- NM
- NY
- NC
- ND
- OH
- OK
- OR
- PA
- RI
- SC
- SD
- TN
- TX
- UT
- VT
- VA
- WA
- WV
- WI
- WY
title: StateCode
PlatformTaskQuestion:
properties:
type:
type: string
const: question
title: Type
default: question
regions:
items:
$ref: '#/components/schemas/RegionRef'
type: array
title: Regions
region_scope:
$ref: '#/components/schemas/LocationScope'
description:
anyOf:
- type: string
- type: 'null'
title: Description
answer:
anyOf:
- type: string
- type: 'null'
title: Answer
is_editable:
type: boolean
title: Is Editable
resolutions:
$ref: '#/components/schemas/PlatformTaskQuestionResolutions'
categories:
items:
$ref: '#/components/schemas/TaskCategory'
type: array
title: Categories
type: object
required:
- regions
- region_scope
- is_editable
- resolutions
- categories
title: PlatformTaskQuestion
HostedSessionRequest:
properties:
callback_url:
type: string
title: Callback Url
type: object
required:
- callback_url
title: HostedSessionRequest
PlatformAgencyAttributeAndValue:
properties:
name:
type: string
title: Name
description:
anyOf:
- type: string
- type: 'null'
title: Description
value:
anyOf:
- type: string
- type: 'null'
title: Value
status:
$ref: '#/components/schemas/PlatformAgencyAttributeStatus'
type: object
required:
- name
- description
- value
- status
title: PlatformAgencyAttributeAndValue
PlatformTaskUpdate:
properties:
status:
$ref: '#/components/schemas/PlatformTaskStatusUpdate'
type: object
required:
- status
title: PlatformTaskUpdate
PlatformTask:
properties:
id:
type: string
title: Id
title:
type: string
title: Title
status:
$ref: '#/components/schemas/PlatformTaskStatus'
source:
$ref: '#/components/schemas/PlatformTaskRequirement'
type: object
required:
- id
- title
- status
- source
title: PlatformTask
AccountTaskResolutionAction:
properties:
type:
type: string
const: action
title: Type
default: action
description:
type: string
title: Description
method:
type: string
title: Method
url:
type: string
title: Url
content_type:
type: string
title: Content Type
fields:
items:
$ref: '#/components/schemas/ActionField'
type: array
title: Fields
type: object
required:
- description
- method
- url
- content_type
- fields
title: AccountTaskResolutionAction
PlatformTaskResolutionHosted:
properties:
type:
type: string
const: hosted
title: Type
default: hosted
description:
type: string
title: Description
method:
type: string
title: Method
url:
type: string
title: Url
content_type:
type: string
title: Content Type
fields:
items:
$ref: '#/components/schemas/ActionField'
type: array
title: Fields
type: object
required:
- description
- method
- url
- content_type
- fields
title: PlatformTaskResolutionHosted
description: Directs a user to take action in order to start a hosted session to complete an action.
CriteriaType:
type: string
enum:
- has-employees
- employee-count
- employee-count-previous-year
- total-employee-count-in-period
- has-non-exempt-employees
- employee-terminated
- payroll-amount
- has-physical-location
- foreign-qualification-date
- date-attribute
- doing-business
- business-income-tax-nexus
- sales-tax-nexus
- estimated-tax-liability
- single-requirement
- charitable-registration-nexus
- partner-nexus
title: CriteriaType
PlatformTaskEstimation:
properties:
min:
type: integer
title: Min
max:
type: integer
title: Max
unit:
$ref: '#/components/schemas/ETAUnit'
type: object
required:
- min
- max
- unit
title: PlatformTaskEstimation
PlatformTaskRequirement:
properties:
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mosey/refs/heads/main/openapi/mosey-tasks-api-openapi.yml