gospace AIDocsAdmin Console

Workplace API

get

Retrieve a list of team settings or a specific team setting by ID, with optional filter for external ID.

Authorizations
Query parameters
location_idstringOptional

Optional ID of the location to retrieve relative settings.

team_idstringOptional

Optional ID of the team to retrieve settings for.

external_idstringOptional

Optional external ID to filter team settings (matches team's external_id).

skipintegerOptional

Number of items to skip for pagination.

Default: 0
limitintegerOptional

Maximum number of items to return.

Default: 25
sortstringOptional

Field to sort by.

orderstring · enumOptional

Sort order, 'asc' or 'desc'.

Default: ascPossible values:
Responses
200

OK

application/json
get
GET /workplace/v1/team/settings HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "team_settings": [
      {
        "_id": "team-setting-1",
        "team_id": "team-1",
        "external_id": "ext-456",
        "settings": {
          "team_name": "Accounting",
          "details": {
            "priority": "high"
          }
        }
      },
      {
        "_id": "team-setting-2",
        "team_id": "team-2",
        "external_id": "ext-789",
        "settings": {
          "team_name": "Planning",
          "details": {
            "priority": "medium"
          }
        }
      }
    ],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 25
      },
      "total_results": 20
    }
  },
  "identifier": "get_team_settings_successful"
}
put

Update multiple existing team settings.

Authorizations
Body
Responses
200

OK

application/json
put
PUT /workplace/v1/team/settings HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 304

{
  "team_settings": [
    {
      "_id": "team-setting-1",
      "team_id": "team-1",
      "external_id": "ext-456",
      "settings": {
        "team_name": "Accounting Updated",
        "details": {
          "priority": "high"
        }
      }
    },
    {
      "_id": "team-setting-2",
      "team_id": "team-2",
      "external_id": "ext-789",
      "settings": {
        "team_name": "Planning Updated",
        "details": {
          "priority": "low"
        }
      }
    }
  ]
}
{
  "success": true,
  "data": {
    "team_settings": [
      {
        "_id": "team-setting-1",
        "team_id": "team-1",
        "external_id": "ext-456",
        "settings": {
          "team_name": "Accounting Updated",
          "details": {
            "priority": "high"
          }
        }
      },
      {
        "_id": "team-setting-2",
        "team_id": "team-2",
        "external_id": "ext-789",
        "settings": {
          "team_name": "Planning Updated",
          "details": {
            "priority": "low"
          }
        }
      }
    ]
  },
  "identifier": "update_team_settings_successful"
}
post

Create one or more occupancy records. Idempotent on (people_id, location_id, seen_at).

Authorizations
Body
location_idstringRequired

ID of the associated location.

Responses
200

Created

application/json
post
POST /workplace/v1/occupancy HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "location_id": "68824ca5369c856b7c670510",
  "occupancy": [
    {
      "people_id": "68820a4b5d11a0df2ce7a5ec",
      "seen_at": "2025-07-24T10:26:19.403Z"
    }
  ]
}
{
  "success": true,
  "data": {
    "info": "Forecasting will be processed at midnight tonight. Trigger manually to force results before.",
    "occupancy": [
      {
        "_id": "689a1e70aa952e3ae432af9f",
        "seen_at": "2025-07-24T10:26:19.403Z",
        "location_id": "68824ca5369c856b7c670510",
        "people_id": "68820a4b5d11a0df2ce7a5ec",
        "occupancy_id": "689a1e70aa952e3ae432af9f"
      }
    ]
  },
  "identifier": "post_occupancy_successful"
}
get

Retrieve occupancy records with optional filters by ID, location, person, and time range.

Authorizations
Query parameters
occupancy_idstringOptional

Filter by a specific occupancy document ID.

location_idstringOptional

Filter by Location ID.

people_idstringOptional

Filter by People ID.

starts_atstring · date-timeOptional

Start (inclusive) of UTC range filter. ISO 8601 with Z.

ends_atstring · date-timeOptional

End (inclusive) of UTC range filter. ISO 8601 with Z.

skipintegerOptional

Number of items to skip.

Default: 0
limitintegerOptional

Max items to return.

Default: 25
sortstringOptional

Field to sort by (e.g., created_at, seen_at, people_id).

Default: created_at
orderstring · enumOptional

Sort order.

Default: ascPossible values:
Responses
200

OK

application/json
get
GET /workplace/v1/occupancy HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "occupancy": [
      {
        "_id": "689a24dd895c4e7f86584013",
        "seen_at": "2025-07-24T10:26:19.403Z",
        "location_id": "68824ca5369c856b7c670510",
        "people_id": "68820a4b5d11a0df2ce7a5ec",
        "created_at": "2025-08-11T17:14:05.257Z",
        "updated_at": "2025-08-11T17:14:05.257Z",
        "occupancy_id": "689a24dd895c4e7f86584013"
      }
    ]
  },
  "pagination": {
    "current_results": {
      "from": 0,
      "to": 10
    },
    "total_results": 1
  },
  "identifier": "get_occupancy_successful"
}
delete

Soft-delete occupancy records that match the filters. Only location_id is required.

Authorizations
Body
location_idstringRequired

Location to scope the deletion.

people_idstringOptional

Optional person filter.

starts_atstring · date-timeOptional

Start (inclusive) of UTC range filter. ISO 8601 with Z.

ends_atstring · date-timeOptional

End (inclusive) of UTC range filter. ISO 8601 with Z.

Responses
200

OK

application/json
delete
DELETE /workplace/v1/occupancy HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 215

{
  "location_id": "68824ca5369c856b7c670510",
  "people_id": "68820a4b5d11a0df2ce7a5ec",
  "starts_at": "2025-07-24T10:26:19.000Z",
  "ends_at": "2025-07-24T10:26:20.000Z",
  "occupancy": [
    {
      "occupancy_id": "689a1de649861b4b2f23868e"
    }
  ]
}
{
  "success": true,
  "data": {
    "info": "Forecasting will be processed at midnight tonight. Trigger manually to force results before.",
    "deleted": 1
  },
  "identifier": "delete_occupancy_successful"
}
post

Trigger forecasting for a location over an optional date range.

Authorizations
Body
location_idstringRequired

Unique identifier of the location to forecast.

Example: 68824ca5369c856b7c670510
starts_atstring · dateOptional

(Optional) Inclusive start date (YYYY-MM-DD).

Example: 2025-06-20
ends_atstring · dateOptional

(Optional) Inclusive end date (YYYY-MM-DD).

Example: 2025-07-31
force_rebuildbooleanOptional

Force a rebuild even if recent results exist.

Default: false
Responses
200

Forecast job created/queued

application/json
post
POST /workplace/v1/forecast/start HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "location_id": "68824ca5369c856b7c670510",
  "starts_at": "2025-06-20",
  "ends_at": "2025-07-31",
  "force_rebuild": false
}
200

Forecast job created/queued

{
  "success": true,
  "data": {
    "location_id": "68824ca5369c856b7c670510",
    "status": "queued",
    "note": "Queued for processing",
    "created_at": "2025-08-11T14:44:14.312Z",
    "updated_at": "2025-08-11T14:44:14.312Z",
    "job_id": "689a01bde5c540bb57b0730b"
  },
  "identifier": "start_forecast_successful"
}
get

Get forecasting job status (supports filtering and pagination).

Authorizations
Query parameters
job_idstringOptional

Filter by a specific forecast job ID returned by /forecast/start.

Example: 689a01bde5c540bb57b0730b
location_idstringOptional

Filter by location ID.

Example: 68824ca5369c856b7c670510
date_fromstring · dateOptional

Filter jobs created on/after this date (YYYY-MM-DD).

date_tostring · dateOptional

Filter jobs created on/before this date (YYYY-MM-DD).

skipintegerOptional

Number of items to skip (pagination).

Default: 0
limitintegerOptional

Maximum number of items to return.

Default: 25
sortstring · enumOptional

Sort field.

Default: created_atPossible values:
orderstring · enumOptional

Sort order.

Default: ascPossible values:
Responses
200

Forecast job status list

application/json
get
GET /workplace/v1/forecast/status HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*
200

Forecast job status list

{
  "success": true,
  "data": {
    "forecast_jobs": [
      {
        "_id": "689a01bde5c540bb57b0730b",
        "location_id": "68824ca5369c856b7c670510",
        "status": "queued",
        "note": "Queued for processing",
        "job_id": "689a01bde5c540bb57b0730b",
        "created_at": "2025-08-11T14:44:14.312Z",
        "updated_at": "2025-08-11T14:44:14.312Z"
      }
    ]
  },
  "pagination": {
    "current_results": {
      "from": 0,
      "to": 1
    },
    "total_results": 1
  },
  "identifier": "get_forecast_job_successful"
}
get

Retrieve a list of location forecasts with optional location_id filter and pagination.

Authorizations
Query parameters
location_idstring[]Optional

Filter by Location ID (can be multiple).

starts_atstring · date-timeOptional

Start date-time in UTC for filtering forecasts.

ends_atstring · date-timeOptional

End date-time in UTC for filtering forecasts.

timezonestringOptional

Timezone of the location. When provided, starts_at and ends_at are interpreted in this timezone. Must be a valid IANA Time Zone identifier.

Example: Europe/London
skipintegerOptional

Number of items to skip for pagination.

Default: 0
limitintegerOptional

Maximum number of items to return.

Default: 25
sortstringOptional

Field to sort by (e.g., starts_at).

orderstring · enumOptional

Sort order, 'asc' or 'desc'.

Default: ascPossible values:
Responses
200

OK

application/json
get
GET /workplace/v1/forecast/locations HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "forecast": [
      {
        "location_id": "text",
        "starts_at": "2025-09-15T21:13:25.120Z",
        "ends_at": "2025-09-15T21:13:25.120Z",
        "forecasted_desks": 1,
        "forecasted_rooms": 1,
        "forecasted_total": 1,
        "forecasted_desks_inc": 1,
        "forecasted_rooms_inc": 1,
        "forecasted_total_inc": 1
      }
    ],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 1
      },
      "total_results": 1
    }
  },
  "identifier": "text"
}
get

Retrieve a list of team forecasts with optional location_id and team_id filters and pagination.

Authorizations
Query parameters
location_idstring[]Optional

Filter by Location ID (can be multiple).

team_idstring[]Optional

Filter by Team ID (can be multiple).

starts_atstring · date-timeOptional

Start date-time in UTC for filtering forecasts.

ends_atstring · date-timeOptional

End date-time in UTC for filtering forecasts.

timezonestringOptional

Timezone of the location. When provided, starts_at and ends_at are interpreted in this timezone. Must be a valid IANA Time Zone identifier.

Example: Europe/London
skipintegerOptional

Number of items to skip for pagination.

Default: 0
limitintegerOptional

Maximum number of items to return.

Default: 25
sortstringOptional

Field to sort by (e.g., starts_at).

orderstring · enumOptional

Sort order, 'asc' or 'desc'.

Default: ascPossible values:
Responses
200

OK

application/json
get
GET /workplace/v1/forecast/teams HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "forecast": [
      {
        "team_id": "text",
        "starts_at": "2025-09-15T21:13:25.120Z",
        "ends_at": "2025-09-15T21:13:25.120Z",
        "location_id": "text",
        "forecasted_desks": 1,
        "forecasted_rooms": 1,
        "forecasted_total": 1,
        "forecasted_desks_inc": 1,
        "forecasted_rooms_inc": 1,
        "forecasted_total_inc": 1
      }
    ],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 1
      },
      "total_results": 1
    }
  },
  "identifier": "text"
}
get

Retrieve a list of people forecasts with optional location_id, people_id, and team_id filters and pagination.

Authorizations
Query parameters
location_idstring[]Optional

Filter by Location ID (can be multiple).

people_idstring[]Optional

Filter by People ID (can be multiple).

team_idstring[]Optional

Filter by Team ID (can be multiple).

starts_atstring · date-timeOptional

Start date-time in UTC for filtering forecasts.

ends_atstring · date-timeOptional

End date-time in UTC for filtering forecasts.

timezonestringOptional

Timezone of the location. When provided, starts_at and ends_at are interpreted in this timezone. Must be a valid IANA Time Zone identifier.

Example: Europe/London
skipintegerOptional

Number of items to skip for pagination.

Default: 0
limitintegerOptional

Maximum number of items to return.

Default: 25
sortstringOptional

Field to sort by (e.g., starts_at).

orderstring · enumOptional

Sort order, 'asc' or 'desc'.

Default: ascPossible values:
Responses
200

OK

application/json
get
GET /workplace/v1/forecast/people HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "forecast": [
      {
        "people_id": "text",
        "starts_at": "2025-09-15T21:13:25.120Z",
        "ends_at": "2025-09-15T21:13:25.120Z",
        "location_id": "text",
        "team_id": "text",
        "forecasted_desk": 1,
        "forecasted_room": 1,
        "forecasted_total": 1
      }
    ],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 1
      },
      "total_results": 1
    }
  },
  "identifier": "text"
}
post

Trigger location AI evolution

Authorizations
Body
location_idstringRequired

Unique identifier of the location.

Example: 68824ca5369c856b7c670510
datestring · dateRequired

Date for the evolution in YYYY-MM-DD format.

Example: 2025-08-08
Responses
200

Successful response

application/json
post
POST /workplace/v1/evolve/start HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "location_id": "68824ca5369c856b7c670510",
  "date": "2025-08-08",
  "settings": {
    "disruption": "MIN",
    "run_by_zone": false
  }
}
200

Successful response

{
  "success": true,
  "data": {
    "evolution_id": "94289524-04ac-44d3-8f05-45b8a937f663",
    "status": "created"
  },
  "identifier": "trigger_evolve_successful"
}
get

Get AI evolution status

Authorizations
Query parameters
evolution_idstringRequired

Unique identifier of a triggered evolution.

Example: 94289524-04ac-44d3-8f05-45b8a937f663
Responses
200

Successful response

application/json
get
GET /workplace/v1/evolve/status HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "success": true,
  "data": {
    "evolution_id": "94289524-04ac-44d3-8f05-45b8a937f663",
    "status": "successful"
  },
  "identifier": "get_evolve_status_successful"
}
get

Retrieve a list of allocations or a specific allocation by ID, with optional filters for location, layer, room, zone, people, team, external ID, or date range.

Authorizations
Query parameters
allocation_idstringOptional

Optional ID of the allocation to retrieve.

location_idstringOptional

Filter by Location ID.

layer_idstringOptional

Filter by Layer ID.

room_idstringOptional

Filter by Room ID.

zone_idstringOptional

Filter by Zone ID.

people_idstringOptional

Filter by People ID.

team_idstringOptional

Filter by Team ID.

external_idstringOptional

Optional external ID to filter allocations (matches external_id of PERSON or TEAM).

starts_atstring · date-timeOptional

Start date-time in UTC for filtering allocations.

ends_atstring · date-timeOptional

End date-time in UTC for filtering allocations.

timezonestringOptional

Timezone of the location. When provided, starts_at and ends_at are interpreted in this timezone. Must be a valid IANA Time Zone identifier.

Example: Europe/London
skipintegerOptional

Number of items to skip for pagination.

Default: 0
limitintegerOptional

Maximum number of items to return.

Default: 25
sortstringOptional

Field to sort by (e.g., starts_at, people_id).

orderstring · enumOptional

Sort order, 'asc' or 'desc'.

Default: ascPossible values:
Responses
200

OK

application/json
get
GET /workplace/v1/allocations HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "allocations": [
      {
        "_id": "alloc-1",
        "location_id": "loc-1",
        "room_id": "room-1",
        "people_id": "person-1",
        "external_id": "ext-123",
        "starts_at": "2025-07-18T09:00:00Z",
        "ends_at": "2025-07-18T17:00:00Z",
        "details": {
          "type": "desk"
        }
      },
      {
        "_id": "alloc-2",
        "location_id": "loc-2",
        "team_id": "team-1",
        "external_id": "ext-456",
        "starts_at": "2025-07-19T09:00:00Z",
        "ends_at": "2025-07-19T17:00:00Z",
        "details": {
          "type": "meeting"
        }
      }
    ],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 25
      },
      "total_results": 20
    }
  },
  "identifier": "get_allocations_successful"
}
post

Create multiple new allocations.

Authorizations
Body
Responses
200

Created

application/json
post
POST /workplace/v1/allocations HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 365

{
  "allocations": [
    {
      "location_id": "loc-1",
      "room_id": "room-1",
      "people_id": "person-1",
      "external_id": "ext-123",
      "starts_at": "2025-07-18T09:00:00Z",
      "ends_at": "2025-07-18T17:00:00Z",
      "details": {
        "type": "desk"
      }
    },
    {
      "location_id": "loc-2",
      "team_id": "team-1",
      "external_id": "ext-456",
      "starts_at": "2025-07-19T09:00:00Z",
      "ends_at": "2025-07-19T17:00:00Z",
      "details": {
        "type": "meeting"
      }
    }
  ]
}
{
  "success": true,
  "data": {
    "allocations": [
      {
        "_id": "alloc-1",
        "location_id": "loc-1",
        "room_id": "room-1",
        "people_id": "person-1",
        "external_id": "ext-123",
        "starts_at": "2025-07-18T09:00:00Z",
        "ends_at": "2025-07-18T17:00:00Z",
        "details": {
          "type": "desk"
        }
      },
      {
        "_id": "alloc-2",
        "location_id": "loc-2",
        "team_id": "team-1",
        "external_id": "ext-456",
        "starts_at": "2025-07-19T09:00:00Z",
        "ends_at": "2025-07-19T17:00:00Z",
        "details": {
          "type": "meeting"
        }
      }
    ]
  },
  "identifier": "create_allocations_successful"
}
put

Update multiple existing allocations.

Authorizations
Body
Responses
200

OK

application/json
put
PUT /workplace/v1/allocations HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 397

{
  "allocations": [
    {
      "_id": "alloc-1",
      "location_id": "loc-1",
      "room_id": "room-1",
      "people_id": "person-1",
      "external_id": "ext-123",
      "starts_at": "2025-07-18T10:00:00Z",
      "ends_at": "2025-07-18T18:00:00Z",
      "details": {
        "type": "desk"
      }
    },
    {
      "_id": "alloc-2",
      "location_id": "loc-2",
      "team_id": "team-1",
      "external_id": "ext-456",
      "starts_at": "2025-07-19T10:00:00Z",
      "ends_at": "2025-07-19T18:00:00Z",
      "details": {
        "type": "meeting"
      }
    }
  ]
}
{
  "success": true,
  "data": {
    "allocations": [
      {
        "_id": "alloc-1",
        "location_id": "loc-1",
        "room_id": "room-1",
        "people_id": "person-1",
        "external_id": "ext-123",
        "starts_at": "2025-07-18T10:00:00Z",
        "ends_at": "2025-07-18T18:00:00Z",
        "details": {
          "type": "desk"
        }
      },
      {
        "_id": "alloc-2",
        "location_id": "loc-2",
        "team_id": "team-1",
        "external_id": "ext-456",
        "starts_at": "2025-07-19T10:00:00Z",
        "ends_at": "2025-07-19T18:00:00Z",
        "details": {
          "type": "meeting"
        }
      }
    ]
  },
  "identifier": "update_allocations_successful"
}
delete

Delete multiple allocations by their IDs.

Authorizations
Body
Responses
200

OK

application/json
delete
DELETE /workplace/v1/allocations HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "allocations": [
    {
      "allocation_id": "alloc-1"
    },
    {
      "allocation_id": "alloc-2"
    }
  ]
}
{
  "success": true,
  "data": {
    "allocations": [
      {
        "allocation_id": "alloc-1"
      },
      {
        "allocation_id": "alloc-2"
      }
    ]
  },
  "identifier": "delete_allocations_successful"
}
get

Retrieve intentions with optional filters. starts_at and ends_at are dates (YYYY-MM-DD) interpreted in the given timezone.

Authorizations
Query parameters
limitinteger · min: 1Optional

the number of records you would like to return in a single request (default 25)

Default: 25Example: 25
skipintegerOptional

the number of records you skip within this request (default 0)

Default: 0Example: 0
sortstringOptional

Field to sort by.

Default: name
orderstring · enumOptional

Sort order.

Default: ascPossible values:
location_idstringOptional
layer_idstringOptional
room_idstringOptional
zone_idstringOptional
people_idstringOptional
team_idstringOptional
external_location_idstringOptional
external_typestring · enumOptional

External intention type.

Possible values:
starts_atstring · dateOptional

Inclusive date (YYYY-MM-DD); interpreted in the provided timezone.

ends_atstring · dateOptional

Inclusive date (YYYY-MM-DD); interpreted in the provided timezone.

location_timezonestringOptional

IANA timezone for interpreting date filters with internal IDs.

Example: Europe/London
external_location_timezonestringOptional

IANA timezone for interpreting date filters with external IDs.

Example: Europe/London
typestring · enumOptional

Internal intention type.

Possible values:
Header parameters
x-configuration-idstringRequired

Configuration context identifier.

Responses
200

OK

application/json
get
GET /workplace/v1/intentions HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
x-configuration-id: text
Accept: */*

{
  "success": true,
  "data": {
    "intentions": [],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 1
      },
      "total_results": 1
    }
  },
  "identifier": "get_intentions_successful"
}
post

Create a single intention (normal allocation flow).

Authorizations
Query parameters
forcebooleanOptional

If true, bypasses certain safety checks and forces creation according to server rules.

Body
statusstring · enumRequiredPossible values:
typestring · enumRequiredPossible values:
location_idstringRequired
people_idstring | nullableOptional
people_first_namestring | nullableOptional
people_last_namestring | nullableOptional
people_emailstring · email | nullableOptional
team_idstring | nullableOptional
team_namestring | nullableOptional
skip_auto_acceptbooleanOptionalDefault: false
Responses
200

Created

application/json
post
POST /workplace/v1/intentions HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 669

{
  "status": "created",
  "type": "DESK",
  "location_id": "text",
  "people_id": "text",
  "people_first_name": "text",
  "people_last_name": "text",
  "people_email": "[email protected]",
  "team_id": "text",
  "team_name": "text",
  "dates": [
    {
      "starts_at": "2025-09-15T21:13:25.120Z",
      "ends_at": "2025-09-15T21:13:25.120Z"
    }
  ],
  "preferences": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "amenities": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "visitors": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "invite_list": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "custom_time": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "fixed_day": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "skip_auto_accept": false,
  "allocation": {
    "room_id": "text",
    "spaces": [
      "text"
    ]
  }
}
{
  "success": true,
  "data": {
    "intentions": []
  },
  "identifier": "create_intention_successful"
}
post

Create one or more intentions using external identifiers/metadata. One of people_id or people_email is required per item.

Authorizations
Body
Responses
200

Created

application/json
post
POST /workplace/v1/intentions/external HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "intentions": [
    null
  ]
}
{
  "success": true,
  "data": {
    "intentions": []
  },
  "identifier": "create_external_intentions_successful"
}
put

Accept a pending intention. If force is 'false', acceptance will fail when there is a conflicting intention. Set force to 'true' to override conflict checks (where permitted).

Authorizations
Path parameters
intention_idstringRequired
Query parameters
forcestring · enumOptional

String flag controlling conflict override.

Default: falseExample: falsePossible values:
Responses
200

OK

application/json
put
PUT /workplace/v1/intentions/{intention_id}/accept HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "intention": null
  },
  "identifier": "accept_intention_successful"
}
put

Decline an invitation for an intention you were invited to. Optionally include a reason.

Authorizations
Path parameters
intention_idstringRequired
Body
reasonstringOptional

Optional reason for declining (audit/notifications).

Responses
200

OK

application/json
put
PUT /workplace/v1/intentions/{intention_id}/decline HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "reason": "Can't make that time"
}
{
  "success": true,
  "data": {
    "intention": null
  },
  "identifier": "decline_intention_successful"
}
put

Cancel an intention. If cancel_for_all is true, the cancellation applies to all invited attendees as well.

Authorizations
Path parameters
intention_idstringRequired
Body

Partial intention update allowed by validator.

reasonstringOptional

Optional cancel reason for audit.

cancel_for_allbooleanOptional

When true, cancel this intention for all invited people as well.

Default: false
Other propertiesanyOptional
Responses
200

OK

application/json
put
PUT /workplace/v1/intentions/{intention_id}/cancel HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "reason": "User canceled booking",
  "cancel_for_all": true
}
{
  "success": true,
  "data": {
    "intention": null
  },
  "identifier": "cancel_intention_successful"
}
delete

Permanently delete a single intention by its ID. This is irreversible and, unlike cancel, the intention cannot be rejoined by any participant once deleted.

Authorizations
Path parameters
intention_idstringRequired
Responses
200

OK

application/json
delete
DELETE /workplace/v1/intentions/{intention_id} HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "data": {
    "intention_id": "text",
    "status": "deleted"
  },
  "identifier": "delete_intention_successful"
}
PreviousDirectory APINextConnections API

Last updated

Was this helpful?