AdminConsole
API reference/Workmate Workforce
POSTstatefullegacy-source evidence

To create new Task

/tasks

Create Task API allows you to assign a new Task to your users. Using this API, You can Assign a new task with a task summary, description, assigned to user, task owner, the priority of the task, task location

Build a requestGet credentials
Legacy contract evidence

This operation was normalized from a MapmyIndia-generation specification. Validate its current Mappls host, path, package entitlement, authentication generation, and commercial availability before production use.

Request target

Call the operation

POSThttps://workmate.mapmyindia.com/apis/tasks
Base URLhttps://workmate.mapmyindia.com/apis/
Authenticationoauth2 bearer
Journey rolecommand
Content typesapplication/json
Path, query, and headers

Parameters

NameLocationTypeDescriptionExample
apiVersionrequired
headerstring

API version should be mentioned in the header along with bearer Token. Available version is v1.0.0, Default version is v1.0.0

v1.0.0
Request body

Body schema

FieldTypeDescriptionExample
namerequired
string

Name of the Task or Task Summary

Collect the cash from customer
description
string

Deatailed description for the Task

Collect the cash and give the invoice and update the System
ownerId
string

The user who creates the task. Unique id of the user

2121
assigneeIdrequired
number

Id of the user to whom this task is assinged. Unique id of the user.

3232
clientIdrequired
number

Unique id of the client. This is the place user will perform the task.

YOUR_CLIENT_ID
prioirity
number

priority of the Task. 0 - None, 1 - Low, 2 - Medium, 3- High.

1
taskListId
string

Unique Id number of the task list.

23
Request body example
{
  "name": "Collect the cash from customer",
  "assigneeId": 3232,
  "clientId": 3222
}
Interactive, local, and credential-safe

Build your request in eight languages

Change source-backed examples once, validate required inputs, and copy the synchronized cURL, JavaScript, Python, Java, C#, Go, PHP, or Ruby request. Credentials remain environment references, and this page never sends a provider request.

Local request composerCode stays local · fixtures are explicit
POSTRequest inputs
1 editable · 0 protected
Generated in eight languages
Environment-backed credentials
POSThttps://workmate.mapmyindia.com/apis/tasks
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request POST \
  --url 'https://workmate.mapmyindia.com/apis/tasks' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{"name":"Collect the cash from customer","assigneeId":3232,"clientId":3222}'

Credential-safe by constructionSet MAPPLS_ACCESS_TOKEN only in your trusted runtime. Code generation stays local. Sandbox execution sends only bounded fixture inputs to this developer platform and never reads a credential or calls Mappls.

Five language quickstarts

Send a production-shaped request

Examples use environment-backed access tokens, explicit timeouts where supported, status checks, and JSON bodies derived from the source schema. Replace sample identifiers and coordinates with values from your application.

POST /tasks
curl --request POST \
  --url 'https://workmate.mapmyindia.com/apis/tasks' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Collect the cash from customer",
  "assigneeId": 3232,
  "clientId": 3222
}'
Success and failure behavior

Responses

201

Task Created

400

Bad Request - Invalid ID supplied or invalid data type.

401

Unauthorized Request. Access to API is forbidden.

403

User type is Field user. Only manager and admin type user have the access to this API

404

Not Found - URL Not Found

201 response fields

FieldTypeDescriptionExample
id
number

Unique Id of the Task.

12
Response example
{
  "id": 12
}
stateful integration

Operate it safely

command

This operation creates or triggers durable state. Supply an idempotency strategy and persist the returned identifier before continuing.

Keep credentials and raw tokens out of source, client bundles, prompts, and logs.Record the operation ID, status, latency, retry count, and source contract version in traces.Classify 4xx responses before retrying; back off and add jitter for retryable 5xx or transport failures.Persist resource identifiers and apply commands exactly once in effect across retries and event replay.
Auditable source

Contract provenance

Source file
contenthub/dochub/mapmyindia-workmate-apis/custom/Task-Management.json
SHA-256
0e978659200a849331e1bf5dca4d90ff915eb72100ef85155b046cd98b007365
Normalization
Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.