Skip to main content
POST
Create application

Restrictions

Usage

  • type must be one of: browser, ios, android, react-native, flutter, kotlin-multiplatform, roku, unity, miniprogram, harmony, electron.
  • client_token is generated by the server and used to initialize the RUM SDK; it is also returned later by POST /rum/application/info.
  • When tracing is sent, open_type (popup or tab) and an http/https endpoint are required even if enabled is false.
  • links.systems[].url must start with http or https; each system needs a name and at least one event_types entry.
  • With alerting.delivery_mode oncall (the default on Flashduty cloud), the server creates or reuses the account’s RUM alerting integration and returns its ID as alerting.integration_id.
  • The team in team_id is not checked against the caller’s own team memberships.
  • Every call is recorded in the account audit log. Don’t put secrets in request fields.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Parameters for creating a RUM application.

application_name
string
required

Application name. 1–40 characters.

Required string length: 1 - 40
team_id
integer<int64>
required

Owning team ID. Get team IDs via POST /team/list.

Required range: x > 1
type
enum<string>
required

Platform identifier:

Available options:
browser,
ios,
android,
react-native,
flutter,
kotlin-multiplatform,
roku,
unity,
miniprogram,
harmony,
electron
alerting
object

Alerting configuration; defaults to disabled (enabled: false) when omitted.

is_private
boolean

If true, only the account owner, account admins, the creator and members of the owning team can see or edit the application. Default false.

Optional external-link integration configuration.

repositories
object[]

Source code repositories to link, in order; the first entry is the primary repository. At most 10 entries.

Maximum array length: 10
no_geo
boolean

If true, geographic location is not inferred from the client IP. Default false.

no_ip
boolean

If true, client IP addresses are not collected. Default false.

tracing
object

Optional APM tracing integration configuration. Stored as empty (enabled: false, empty open_type and endpoint) when omitted.

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

Result of creating a RUM application.