Get Information About Stage rpa.stage.get

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

Scope: rpa

Who can execute the method: any user

DEPRECATED

The development of this method has been halted. Use Smart scripts as an alternative to this functionality.

This method retrieves information about a stage by its id.

Stage Parameters

Required parameters are marked with *

Name
type

Description

id*
number

Identifier of the stage

Response Handling

HTTP status: 200

{
            "id": 1,
            "name": "Launch",
            "code": "",
            "color": "22B9FF",
            "sort": 1000,
            "semantic": null,
            "typeId": 1,
            "isFirst": true,
            "isSuccess": false,
            "isFail": false,
            "tasks": [
                {
                    "title": "Task",
                    "robotType": "RpaApproveActivity",
                    "robotName": "A43555_78925_98855_46118",
                    "canAppendResponsibles": true,
                    "users": [
                        {
                            "id": "U1",
                            "entityId": 1,
                            "name": "Anton",
                            "photoSrc": "",
                            "url": "\/company\/personal\/user\/1\/",
                            "entityType": "users"
                        },
                        {
                            "id": "U4",
                            "entityId": 4,
                            "name": "Piter",
                            "photoSrc": "",
                            "url": "\/company\/personal\/user\/4\/",
                            "entityType": "users"
                        }
                    ]
                }
            ],
            "robotsCount": 0,
            "possibleNextStages": [1,2,3,4,5],
            "permissions": {
                "droppable": true,
                "canMoveFrom": true
            }
        }

Returned Data

Name

Description

name

Name of the stage

code

Symbolic code. Can be used as an external identifier

color

HEX color code of the stage, 6 characters

sort

Sorting index

semantic

Semantic code of the stage. Can be either SUCCESS or FAIL

typeId

Identifier of the process

isFirst

Computed field. Returns true if this is the first stage of the process

isSuccess

Computed field. Returns true if this stage is successful

isFail

Computed field. Returns true if this stage has failed

tasks

Array of tasks for the stage. Each entry has the following structure:

  • title — title of the task
  • robotType — type of the task. Can take one of the following values:
    • RpaApproveActivity — approve or reject
    • RpaMoveActivity — simply move
    • RpaRequestActivity — request information
    • RpaReviewActivity — review information
  • robotName — name of the activity
  • users — array of participants for the task to be displayed in the kanban at the stage

robotsCount

computed field. Number of robots at the stage

possibleNextStages

array of identifiers of stages to which the item can be moved. Not used

permissions

set of permissions for the kanban:

  • droppable — items can be moved to this stage
  • canMoveFrom — items can be moved from this stage

Continue Learning

Previous
Update Stage
Next
Get List of Process Stages