Act! CRM

Act! CRM Task Types API

The Task Types API from Act! CRM — 4 operation(s) for task types.

Documentation GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/task-types/{taskTypeId}/regarding-dropdown Get a task type's regarding options · Gets the regarding dropdown list by task type id #

Ask an LLM

“What regarding options are offered for a given task type?”

“Where do I get the regarding dropdown list for a task type?”

Tell an agent

Get the regarding dropdown for task type {taskTypeId}.

Show the regarding choices for task type {taskTypeId}.

GET /api/task-types List task types · Gets all task types #

Ask an LLM

“What task types are available?”

“Can I see both built-in and custom task types?”

Tell an agent

List all task types.

Show every task type.

POST /api/task-types Create a custom task type · Create a new custom task types #

Ask an LLM

“How do I add a custom task type?”

“Can a new task type be created inactive?”

Tell an agent

Create a custom task type named {name}.

Create task type {name} with description {description}.

GET /api/task-types/{id} Get a task type · Get task type by identifier #

Ask an LLM

“How do I look up one task type by ID?”

“Is a specific task type custom or deletable?”

Tell an agent

Show task type {id}.

Get the details of task type {id}.

PUT /api/task-types/{id} Replace a custom task type · Update an already existing custom task type #

Ask an LLM

“How do I fully update a custom task type?”

“Can I overwrite a custom task type's name and description together?”

Tell an agent

Update task type {id} with name {name} and description {description}.

Overwrite custom task type {id} with history types {historyTypes}.

DELETE /api/task-types/{id} Delete a custom task type · Delete an existing custom task type #

Ask an LLM

“How do I delete a custom task type?”

“Can I remove a task type I created?”

Tell an agent destructive · confirm first

Delete task type {id}.

Remove custom task type {id}.

PATCH /api/task-types/{id} Partially update a custom task type · Partially update an already existing custom task type #

Ask an LLM

“Can I deactivate a custom task type without changing anything else?”

“Is there a partial update for a single task type?”

Tell an agent

Rename task type {id} to {name}.

Set task type {id} active flag to {isActive}.

PATCH /api/task-types/batch Update several task types at once · Partially update for list of already created task types #

Ask an LLM

“Can I partially update a batch of task types in one call?”

“What patches multiple existing task types together?”

Tell an agent

Update this batch of task types.

Apply partial updates to several task types at once.

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/act/refs/heads/main/openapi/act-task-types-api-openapi.yml

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/act:act-task-types-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  version: v1
  title: act.web.api Task Types API
servers:
- url: https://apimta.act.com/act.web.api
tags:
- name: Task Types
paths:
  /api/task-types/{taskTypeId}/regarding-dropdown:
    get:
      tags:
      - Task Types
      summary: Gets the regarding dropdown list by task type id
      operationId: TaskTypes_GetRegardingDropdownList_9668D3E9
      parameters:
      - name: taskTypeId
        in: path
        description: ''
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.MetaData.Picklists.DropDownPickListItem'
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.MetaData.Picklists.DropDownPickListItem'
            text/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.MetaData.Picklists.DropDownPickListItem'
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '500':
          description: Unexpected error.
      deprecated: false
  /api/task-types:
    get:
      tags:
      - Task Types
      summary: Gets all task types
      operationId: TaskTypes_Get_CA70DD31
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            text/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '500':
          description: Unexpected error.
      deprecated: false
    post:
      tags:
      - Task Types
      summary: Create a new custom task types
      operationId: TaskTypes_Post_49D8FCA6
      responses:
        '201':
          description: Created indicates that the request resulted in a new resource created before the response was sent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          text/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        description: The custom task type definition.
        required: true
  /api/task-types/{id}:
    get:
      tags:
      - Task Types
      summary: Get task type by identifier
      operationId: TaskTypes_GetById_82B0E217
      parameters:
      - name: id
        in: path
        description: The unique identifier (id) for a given task type.
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '500':
          description: Unexpected error.
      deprecated: false
    put:
      tags:
      - Task Types
      summary: Update an already existing custom task type
      operationId: TaskTypes_Put_85CD258C
      parameters:
      - name: id
        in: path
        description: The unique identifier (id) for a given custom task type.
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          text/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        description: The custom task type definition.
        required: true
    delete:
      tags:
      - Task Types
      summary: Delete an existing custom task type
      operationId: TaskTypes_Delete_AA10E002
      parameters:
      - name: id
        in: path
        description: The unique identifier (id) for a given custom task type.
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '204':
          description: NoContent indicates that the request has been successfully processed and that the response is intentionally blank.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/System.Object'
            application/xml:
              schema:
                $ref: '#/components/schemas/System.Object'
            text/xml:
              schema:
                $ref: '#/components/schemas/System.Object'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
    patch:
      tags:
      - Task Types
      summary: Partially update an already existing custom task type
      operationId: TaskTypes_Patch_C3E0417B
      parameters:
      - name: id
        in: path
        description: The unique identifier (id) for a given custom task type.
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          text/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        description: The custom task type definition.
        required: true
  /api/task-types/batch:
    patch:
      tags:
      - Task Types
      summary: Partially update for list of already created task types
      operationId: TaskTypes_PatchUpdateBatchOfActivityTasks_DE61FFCD
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
            text/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/xml:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          text/xml:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
          application/x-www-form-urlencoded:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskType'
        description: The list of custom task type.
        required: true
components:
  schemas:
    act.web.api.models.Preferences.TaskDefaultPreferences:
      description: ''
      type: object
      properties:
        priority:
          format: int32
          description: Tasks type priority.
          type: integer
        reminder:
          format: int32
          description: The number of minutes before the tasks starts.
          type: integer
        duration:
          format: int32
          description: The number of minutes which the task with exists or lasts.
          type: integer
        isAllDayEvent:
          description: All day event.
          type: boolean
        autoRollover:
          description: Allow auto roll over to today.
          type: boolean
        color:
          description: 'Calendar hex color for a given task type [Green = #00b19e, Orange = #fe5000, Purple = #566bee, Plum = #9d04b8, Blue = #03b3ff, Yellow = #e5cd48, Raspberry = #be2951, Emerald = #26906f, DarkBlue = #008cc5, Grape = #263690] | <b>GET: api/preferences/task-types/color-palette</b>.'
          type: string
        taskDropDownFields:
          description: ''
          type: array
          items:
            $ref: '#/components/schemas/act.web.api.models.Preferences.TaskTypeDropDownFieldPreferences'
    act.web.api.models.TaskTypes.TaskType:
      description: ''
      type: object
      properties:
        id:
          format: int32
          description: ''
          type: integer
        name:
          description: ''
          type: string
        description:
          description: ''
          type: string
        isActive:
          description: ''
          type: boolean
        isCustom:
          description: ''
          type: boolean
        isDeletable:
          description: Indicate that the task type can be deleted.
          type: boolean
        taskTypeGuid:
          description: ''
          type: string
        historyTypes:
          description: ''
          type: array
          items:
            $ref: '#/components/schemas/act.web.api.models.TaskTypes.TaskTypesHistoryType'
        defaultPreferences:
          $ref: '#/components/schemas/act.web.api.models.Preferences.TaskDefaultPreferences'
          description: ''
    act.web.api.models.Preferences.TaskTypeDropDownFieldPreferences:
      description: Describe activity type fields preferences.
      type: object
      properties:
        code:
          description: Field type.
          type: string
        value:
          description: Display drop-down to this field.
          type: boolean
    act.web.api.models.MetaData.Picklists.DropDownPickListItem:
      description: Represents a value item for a PickList object.
      type: object
      properties:
        id:
          description: Gets the unique identifier of the PickListItem object.
          type: string
        value:
          description: Gets or sets the value of the PickListItem object.
          type: string
        description:
          description: Gets the description of the picklist item.
          type: string
    System.Object:
      type: object
      properties: {}
    act.web.api.models.TaskTypes.TaskTypesHistoryType:
      description: ''
      type: object
      properties:
        id:
          format: int32
          description: ''
          type: integer
        name:
          description: Gets the name of this history type.
          type: string
        description:
          description: Gets brief description of this history type.
          type: string
        clearType:
          description: ''
          enum:
          - OTHER
          - COMPLETED
          - NOTCOMPLETED
          - ERASED
          type: string
        isDefault:
          description: Indicates that this history type is default.
          type: boolean