Across API

To use the Across API, login and click on the Developer tab on the left. Click the refresh button to generate an API key. Include the API key in your header

post
Create task

https://acrossapp.com/externalapi/createtask
Create a task in Across
Request
Response
Request
Headers
api-key
required
string
Your API key from the Across developer dashboard
Body Parameters
channelId
optional
string
ID of the Slack channel this task should be associated with
isPrivate
optional
boolean
Private tasks are not shared with your customers in Slack
dueDate
optional
object
Javascript Date object for when task is due
priority
optional
number
1 = Low, 2 = Medium, 3 = High, 4 = Urgent
description
optional
string
Description of task
affected
optional
array
Array of Slack IDs (strings) of customers affected by this issue
assignedTo
optional
string
Slack ID of user this task is assigned to
title
required
string
Title of your task
Response
200: OK
{
success: true,
createdTask:
{
taskId: '5ea0a6dcdda982f28f33a3b8',
title: 'Sample task',
description: 'This is a sample task',
priority: 2,
dueDate: "2020-04-22T20:19:40.268Z',
affected: [
{
name: 'Russ Hanneman',
slackId: 'UUF40SE2L'
}
],
assignedTo: {
name: 'Richard Hendricks',
slackId: 'UTK44S92L'
},
channelId: 'C014TGDJNF8',
isPrivate: true
}
}
400: Bad Request
{
success: false,
message: 'Error: Reason here'
}

post
Resolve task

https://acrossapp.com/externalapi/resolvetask
Resolve a task in Across
Request
Response
Request
Headers
api-key
required
string
Your API key from the Across developer dashboard
Body Parameters
taskId
required
string
ID of the task you want to resolve
Response
200: OK
{
success: true
}
400: Bad Request
{
success: false,
message: 'Error: Reason here'
}

post
Get users

https://acrossapp.com/externalapi/getusers
Get users in your Slack workspace
Request
Response
Request
Headers
api-key
required
string
Your API key from the Across developer dashboard
Response
200: OK
{
success: true,
users: [
{
name: 'Richard Hendricks',
isCustomer: false,
slackId: 'UPE7U2EC4',
},
...
]
}
400: Bad Request
{
success: false,
message: 'Error: Reason here'
}

post
Create shared channel

https://acrossapp.com/externalapi/createsharedchannel
Create a shared channel. Email us at [email protected] to get access to this API. Requires manual setup.
Request
Response
Request
Headers
api-key
required
string
Your API key from the Across developer dashboard
Response
200: OK
{
success: true,
link: 'https://join.slack.com/share/I012C9NTTMG/....'
}
400: Bad Request
{
success: false,
message: 'Error: Failed to create shared channel'
}