Set up CE Broker reporting

PUT/v1/organization/{orgId}/learning/workspace/reporting/ce-broker

US Region: https://public-api.sessionboard.com · EU Region: https://public-api-eu.sessionboard.com

The provider number, a default profession for learners who have not given theirs, and a CE Broker course number per credited course (null removes one). Waits for a person's OK (202 needs_approval). Requires write:learning. Also at PUT /v1/learning/workspace/reporting/ce-broker.

Request example

curl --request PUT \
  --url 'https://public-api.sessionboard.com/v1/organization/{orgId}/learning/workspace/reporting/ce-broker' \
  --header 'x-access-token: <api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "providerNumber": "50-1234",
  "defaultProfession": "RN",
  "courseNumbers": {
    "key": "<string>"
  },
  "uploadKey": "<string>"
}'

const response = await fetch('https://public-api.sessionboard.com/v1/organization/{orgId}/learning/workspace/reporting/ce-broker', {
  method: 'PUT',
  headers: {
    "x-access-token": "<api-token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "providerNumber": "50-1234",
    "defaultProfession": "RN",
    "courseNumbers": {
      "key": "<string>"
    },
    "uploadKey": "<string>"
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.request(
    "PUT",
    "https://public-api.sessionboard.com/v1/organization/{orgId}/learning/workspace/reporting/ce-broker",
    headers={
        "x-access-token": "<api-token>",
        "Content-Type": "application/json"
    },
    json={
        "providerNumber": "50-1234",
        "defaultProfession": "RN",
        "courseNumbers": {
            "key": "<string>"
        },
        "uploadKey": "<string>"
    },
)

print(response.json())

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://public-api.sessionboard.com/v1/organization/{orgId}/learning/workspace/reporting/ce-broker",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_POSTFIELDS => '{
  "providerNumber": "50-1234",
  "defaultProfession": "RN",
  "courseNumbers": {
    "key": "<string>"
  },
  "uploadKey": "<string>"
}',
    CURLOPT_HTTPHEADER => [
        "x-access-token: <api-token>",
        "Content-Type: application/json",
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
  "strings"
)

func main() {
  req, _ := http.NewRequest("PUT", "https://public-api.sessionboard.com/v1/organization/{orgId}/learning/workspace/reporting/ce-broker", strings.NewReader(`{
  "providerNumber": "50-1234",
  "defaultProfession": "RN",
  "courseNumbers": {
    "key": "<string>"
  },
  "uploadKey": "<string>"
}`))
  req.Header.Add("x-access-token", "<api-token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(string(body))
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://public-api.sessionboard.com/v1/organization/{orgId}/learning/workspace/reporting/ce-broker"))
    .header("x-access-token", "<api-token>")
    .header("Content-Type", "application/json")
    .method("PUT", HttpRequest.BodyPublishers.ofString("{\n  \"providerNumber\": \"50-1234\",\n  \"defaultProfession\": \"RN\",\n  \"courseNumbers\": {\n    \"key\": \"<string>\"\n  },\n  \"uploadKey\": \"<string>\"\n}"))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

Try it

Response headers

Authorizations

x-access-tokenstringheader
Organization API token. Generate from Organization Settings → API Tokens.
AuthorizationBearer <token>headeror
OAuth 2.1 access token. Obtained via the OAuth PKCE flow at /oauth/token.

Send one of these. See Authentication.

Path parameters

orgIdstringpathrequired
Your organization ID. Any other organization returns 404.

Request body

application/jsonrequired

providerNumberstring | null
Max length
20
Example
"50-1234"
defaultProfessionstring | null
Max length
8
Example
"RN"
courseNumbersobject
Course id → CE Broker course number (20-123456).
uploadKeystring | null
The CE Broker upload key, for a live account. Write-only; never returned.
Max length
200

Example

{
  "providerNumber": "50-1234",
  "defaultProfession": "RN",
  "courseNumbers": {
    "key": "<string>"
  },
  "uploadKey": "<string>"
}

Responses

202`application/json`

Waiting for a person. Nothing was published or sent: a person approves or declines the request in Sessionboard Learning (payload.url), and it then runs as them. Do not call again.

successboolean
payloadLearningApprovalRequest
Show child attributes
- statusstring
- approval_idstring<uuid>
- urlstring
  Where a person approves or declines it, in Sessionboard Learning.
- messagestring
  Waiting for your OK in Sessionboard: <url>
- notestring
  Says nothing was sent or published and not to call again.
- approvalLearningApproval
  Show child attributes
  - idstring<uuid>
  - statusstring
    Allowed values
    "pending", "approved", "declined", "failed"
  - actionstring
    publish_course, publish_on_demand or publish_course_draft.
  - surfacestring
    courses for these operations.
  - titlestring
    The approval card's headline, e.g. Publish the course “Intro to Safety”.
  - summarystring
    What the person asked the assistant, when given (From “…”), else empty.
  - targetobject | null
    Show child attributes
    typestring
    course, event or course_draft.
    idstring
  - event_idinteger | null
  - assistantobject
    Show child attributes
    vendorstring
    labelstring
    clientstring | null
    viastring | null
    Allowed values
    "api_token", "oauth", null
  - requested_byobject
    Show child attributes
    user_idinteger | null
    namestring | null
  - decided_byobject | null
    Show child attributes
    user_idinteger
    namestring | null
  - decided_atstring<date-time> | null
  - errorstring | null
  - remedyobject | null
    Set only when a run failed for a reason a person can fix in one step.
  - can_retryboolean
  - created_atstring<date-time>
  - productstring
  - urlstring

400`application/json`

A path, query or body value failed validation, or an unknown body property was sent. message names the field. (A source object naming the assistant, with the person's prompt, is accepted on every write and removed before validation.) For an {eventId} path that is not a whole number: error: VALIDATION_ERROR, eventId must be a valid integer.