Menu

Tasks

2 endpoints in the Mattering Sales API.

GETPOST tasks/ User APIService tier

List tasks, or create one with POST. derived from route

URL

  • User APIhttps://sales.mattering.io/api/user/v1/tasks/
  • Service tierhttps://sales.mattering.io/api/internal/tasks/

Query parameters

NameDefault
due_afternone
due_beforenone
sortnone
updated_afternone
updated_beforenone

Body keys (JSON)

KeyRequiredDefault
assigned_to_emailoptional or conditionalnone
business_idoptional or conditionalnone
contact_idoptional or conditionalnone
descriptionoptional or conditionalnone
due_dateoptional or conditionalnone
priorityoptional or conditionalnone
statusoptional or conditionalnone
tagsoptional or conditionalnone
titleoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view, silently. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Pagination

Accepts limit and offset. The response meta carries total, returned, has_more and next_offset.

Responses

200 data and meta envelope

{
  "data": {
    "tasks": [
      {
        "...": "..."
      }
    ]
  },
  "meta": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "returned": 0,
    "has_more": true,
    "next_offset": 0
  }
}

201 data and meta envelope

{
  "data": {
    "task": {
      "...": "..."
    }
  },
  "meta": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "returned": 0,
    "has_more": true,
    "next_offset": 0
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400anchor_mismatch
400invalid_due_date
400invalid_json
400invalid_priority
400invalid_status
400missing_field
400tags_must_be_list
404business_not_found
404contact_not_found
404owner_not_found

Example

curl -X POST "https://sales.mattering.io/api/user/v1/tasks/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "assigned_to_email": "...",
  "business_id": "...",
  "contact_id": "...",
  "description": "...",
  "due_date": "...",
  "priority": "...",
  "status": "...",
  "tags": "..."
}'

Source: CRMCore/timeline_api.py (timeline_api.tasks)

GETPATCHDELETE tasks/{task_id}/ User APIService tier

Read, update or delete one of the tasks by id. derived from route

This read is not paginated. It returns at most 255 rows and does not report a total, so a result of exactly 255 may be truncated.

URL

  • User APIhttps://sales.mattering.io/api/user/v1/tasks/{task_id}/
  • Service tierhttps://sales.mattering.io/api/internal/tasks/{task_id}/

Path parameters

NameType
task_iduuid

Responses

200 data and meta envelope

{
  "data": {
    "id": "...",
    "deleted": true
  }
}

200 data and meta envelope

{
  "data": {
    "task": {
      "...": "..."
    }
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400invalid_due_date
400invalid_json
400invalid_priority
400invalid_status
400missing_field
404not_found
404owner_not_found

Example

curl -X GET "https://sales.mattering.io/api/user/v1/tasks/TASK_ID/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: CRMCore/timeline_api.py (timeline_api.task_detail)

All Sales resources
Start Free Explore our Products