AI agent? Read this page as Markdown at /genai/task/Create_a_task.md — append .md to any docs URL, or start from /llms.txt.
Create a task
POST/genai/{connection_id}/task
Parameters
fieldsstring array
Fields to return
rawstring
Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar
connection_idstring required
ID of the connection
Payload
idstring
created_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
updated_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
namestring
A short human-readable title for the coding agent task.
instructionsstring
The natural-language instructions given to the coding agent.
model_idstring
user_idstring
(reference to HrisEmployee)
repo_urlstring
The git repository that the coding agent works in.
source_branch_identifierstring
The name of the branch that the coding agent starts its work from.
target_branch_identifierstring
The name of the branch that the coding agent pushed its work to.
pullrequest_urlstring
The pull/merge request that the coding agent opened for its work.
web_urlstring
The provider's own web page for this task.
summarystring
The coding agent's summary of the work that it performed.
errorstring
The failure description (when the status is FAILED).
files_changednumber
lines_addednumber
lines_deletednumber
tokens_usednumber
started_atdate
When the coding agent started working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
completed_atdate
When the coding agent stopped working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
agent_idstring
id of the genai_agent (the reusable agent/preset configuration) that runs this task.
organization_idstring
id of the genai_organization (the organization or execution environment) that this task runs under.
Returns
idstring
created_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
updated_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
namestring
A short human-readable title for the coding agent task.
instructionsstring
The natural-language instructions given to the coding agent.
model_idstring
user_idstring
(reference to HrisEmployee)
repo_urlstring
The git repository that the coding agent works in.
source_branch_identifierstring
The name of the branch that the coding agent starts its work from.
target_branch_identifierstring
The name of the branch that the coding agent pushed its work to.
pullrequest_urlstring
The pull/merge request that the coding agent opened for its work.
web_urlstring
The provider's own web page for this task.
summarystring
The coding agent's summary of the work that it performed.
errorstring
The failure description (when the status is FAILED).
files_changednumber
lines_addednumber
lines_deletednumber
tokens_usednumber
started_atdate
When the coding agent started working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
completed_atdate
When the coding agent stopped working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
agent_idstring
id of the genai_agent (the reusable agent/preset configuration) that runs this task.
organization_idstring
id of the genai_organization (the organization or execution environment) that this task runs under.
const options = {
method: 'POST',
url: 'https://api.unified.to/genai/5de520f96e439b002043d8dc/task',
headers: {
authorization: 'bearer .....'
},
data: undefined,
params: {
fields: '',
raw: '',
}
};
const results = await axios.request(options); Are we missing anything? Let us know