OpenAPI reference

Sender ActiveChargingProfile update

PUT/chargingprofiles/{session_id}

The Receiver (typically CPO) informs the Sender (typically eMSP/SCSP) that the ActiveChargingProfile changed for an ongoing session that the Sender previously set a profile on. The eMSP forwards the s

API: OCPI 2.2.1 (eMSP) · Module: Charging Profiles (eMSP Sender)
Base path: /chargingprofiles · Base URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1

Overview

PUT /chargingprofiles/{session_id}

Absolute URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/chargingprofiles/{session_id}

Requires authentication. Use Authorization: Token <token>. See OCPI credentials.

How to call

Quick Shell sample (set OCPI_TOKEN when auth is required). Full Python and TypeScript under Examples.

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/chargingprofiles/SESSION1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"start_date_time":"2026-03-28T10:00:00Z","charging_profile":{"charging_rate_unit":"W","charging_profile_period":[{"start_period":0,"limit":11000},{"start_period":3600,"limit":7000}]}}'

Request

Path parameters

Name	Type	Required	Description
`session_id`	`string`	Yes	Session.id of the Session object.

Request body

application/json · Required

Schema: ActiveChargingProfile

Field	Type	Required	Description
`start_date_time`	`string (date-time)`	Yes	—
`charging_profile`	`ChargingProfile`	Yes	`ChargingProfile`

Request example

1{
2  "start_date_time": "2026-03-28T10:00:00Z",
3  "charging_profile": {
4    "charging_rate_unit": "W",
5    "charging_profile_period": [
6      {
7        "start_period": 0,
8        "limit": 11000
9      },
10      {
11        "start_period": 3600,
12        "limit": 7000
13      }
14    ]
15  }
16}

Responses

Status	Description	Schema
`200`	Successful Response	`BaseResponse`
`401`	Unauthorized	`—`
`404`	Not Found	`—`
`422`	Validation Error	`HTTPValidationError`

`200` — successful response

application/json

Schema: BaseResponse

Field	Type	Required	Description
`status_code`	`integer`	No	Default: `1000`
`status_message`	`string`	No	—
`timestamp`	`string (date-time)`	No	—

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z"
5}

`401` — unauthorized

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Unauthorized",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`404` — not found

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Session not found",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`422` — validation error

application/json

Schema: HTTPValidationError

Field	Type	Required	Description
`detail`	`ValidationError[]`	No	`Detail`

Response example

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": {
8        "_type": "Input"
9      },
10      "ctx": {
11        "_type": "Context"
12      }
13    }
14  ]
15}

Examples

Shell, Python, and TypeScript (set OCPI_TOKEN when auth is required).

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/chargingprofiles/SESSION1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"start_date_time":"2026-03-28T10:00:00Z","charging_profile":{"charging_rate_unit":"W","charging_profile_period":[{"start_period":0,"limit":11000},{"start_period":3600,"limit":7000}]}}'

OpenAPI reference

Sender ActiveChargingProfile update

PUT/chargingprofiles/{session_id}

API: OCPI 2.2.1 (eMSP) · Module: Charging Profiles (eMSP Sender)
Base path: /chargingprofiles · Base URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1

Overview

PUT /chargingprofiles/{session_id}

Absolute URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/chargingprofiles/{session_id}

Requires authentication. Use Authorization: Token <token>. See OCPI credentials.

How to call

Quick Shell sample (set OCPI_TOKEN when auth is required). Full Python and TypeScript under Examples.

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/chargingprofiles/SESSION1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"start_date_time":"2026-03-28T10:00:00Z","charging_profile":{"charging_rate_unit":"W","charging_profile_period":[{"start_period":0,"limit":11000},{"start_period":3600,"limit":7000}]}}'

Request

Path parameters

Name	Type	Required	Description
`session_id`	`string`	Yes	Session.id of the Session object.

Request body

application/json · Required

Schema: ActiveChargingProfile

Field	Type	Required	Description
`start_date_time`	`string (date-time)`	Yes	—
`charging_profile`	`ChargingProfile`	Yes	`ChargingProfile`

Request example

1{
2  "start_date_time": "2026-03-28T10:00:00Z",
3  "charging_profile": {
4    "charging_rate_unit": "W",
5    "charging_profile_period": [
6      {
7        "start_period": 0,
8        "limit": 11000
9      },
10      {
11        "start_period": 3600,
12        "limit": 7000
13      }
14    ]
15  }
16}

Responses

Status	Description	Schema
`200`	Successful Response	`BaseResponse`
`401`	Unauthorized	`—`
`404`	Not Found	`—`
`422`	Validation Error	`HTTPValidationError`

`200` — successful response

application/json

Schema: BaseResponse

Field	Type	Required	Description
`status_code`	`integer`	No	Default: `1000`
`status_message`	`string`	No	—
`timestamp`	`string (date-time)`	No	—

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z"
5}

`401` — unauthorized

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Unauthorized",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`404` — not found

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Session not found",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`422` — validation error

application/json

Schema: HTTPValidationError

Field	Type	Required	Description
`detail`	`ValidationError[]`	No	`Detail`

Response example

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": {
8        "_type": "Input"
9      },
10      "ctx": {
11        "_type": "Context"
12      }
13    }
14  ]
15}

Examples

Shell, Python, and TypeScript (set OCPI_TOKEN when auth is required).

1curl -sS -X PUT 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/chargingprofiles/SESSION1' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"start_date_time":"2026-03-28T10:00:00Z","charging_profile":{"charging_rate_unit":"W","charging_profile_period":[{"start_period":0,"limit":11000},{"start_period":3600,"limit":7000}]}}'

Sender ActiveChargingProfile update

Overview

How to call

Request

Path parameters

Request body

Request example

Responses

`200` — successful response

`401` — unauthorized

`404` — not found

`422` — validation error

Examples

Is this helpful?

AI Tools

On this page

Sender ActiveChargingProfile update

Overview

How to call

Request

Path parameters

Request body

Request example

Responses

`200` — successful response

`401` — unauthorized

`404` — not found

`422` — validation error

Examples

Is this helpful?

AI Tools

On this page