10-resource-positions

Resource Positions (Canvas/Draggable Cards)

Resources (instances, applications, databases, firewalls, terminals, storage buckets, bucket explorers, db monitors) can be positioned on a canvas for drag-and-drop interfaces (like n8n). Position data is automatically included in all resource listing and detail endpoints.

Update Resource Position

PATCH /api/:projectSlug/:environmentSlug/resources/:resourceId/position - Update the position of a resource on the canvas (use resource’s database ID)

Request Body:

{
  "x": 520,
  "y": 150
}

Example:

curl -X PATCH "https://api.gateways.app/api/codepanel/master1/resources/123/position" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"x": 520, "y": 150}'

Example Response:

{
  "message": "Resource position updated successfully",
  "data": {
    "id": 1,
    "resourceType": "instance",
    "position": {
      "x": 520,
      "y": 150
    }
  }
}

Position Data in Resource Responses: Position data is automatically included in all resource listing and detail endpoints:

{
  "id": 1,
  "resourceType": "instance",
  "name": "My Server",
  "position": {
    "x": 520,
    "y": 150
  },
  // ... other fields
}

If a resource doesn’t have a position set, the position field will be null. Example Response (with position):

{
  "message": "Resources retrieved successfully",
  "count": 2,
  "data": [
    {
      "id": 1,
      "resourceType": "instance",
      "name": "Web Server",
      "position": {
        "x": 520,
        "y": 150
      },
      "metadata": { ... }
    },
    {
      "id": 2,
      "resourceType": "database",
      "name": "Main DB",
      "position": {
        "x": 800,
        "y": 300
      },
      "metadata": { ... }
    }
  ]
}

​Resource Positions (Canvas/Draggable Cards)

​Update Resource Position

Resource Positions (Canvas/Draggable Cards)

Update Resource Position