Get job runtime environment details | Jobs | Northflank API docs
v1
Double column
API
CLI
JS Client

Jobs /

Get job runtime environment details

Get details about the runtime environment accessible by the given job. Also requires the permission 'Project > Secrets > General > Read'

Required permission

Project > Jobs > Configuration > View Environment Variables

Path parameters

    • projectId

      string required

      ID of the project

    • jobId

      string required

      ID of the job

Response body

  • {object}

    Response object.

    • data

      {object} required

      Result data.

      • runtimeEnvironment

        {object} required

        Details about all the secrets accessible by the service.

        • MY_VARIABLE_NAME

          {object}

          A stored secret and details about it and its value. This can have the name of any saved secret.

          • value

            required

            The value of the secret.

          • inheritedFrom

            string

            The ID of the secret group the secret is inherited from, if applicable.

          • addonId

            string

            The ID of the addon the secret is inherited from, if applicable.

          • priority

            integer

            The priority of the secret group the secret is inherited from, if applicable.

          • overriding

            [array] required

            An array containing data about other places the secret has been inherited from, but that are not being used as a secret with the same key exists with a higher priority.

            • {object}

              Data about an overridden secret.

              • value

                required

                The value of the secret.

              • inheritedFrom

                string required

                The ID of the secret group the secret is inherited from.

              • addonId

                string

                The ID of the addon the secret is inherited from, if applicable.

              • priority

                integer required

                The priority of the secret group the secret is inherited from.

      • runtimeFiles

        {object} required

        Details about all the secrets accessible by the service.

        • /dir/fileName

          {object}

          A stored secret and details about it and its value. This can have the name of any saved secret.

          • value

            {object} required

            The value of the secret.

            • data

              string

              base64 encoded string of the file contents

            • encoding

              string

              Original encoding of the file

          • inheritedFrom

            string

            The ID of the secret group the secret is inherited from, if applicable.

          • priority

            integer

            The priority of the secret group the secret is inherited from, if applicable.

          • overriding

            [array] required

            An array containing data about other places the file has been inherited from, but that are not being used as a secret with the same file path exists with a higher priority.

            • {object}

              Data about an overridden secret.

              • value

                required

                The value of the secret.

              • inheritedFrom

                string required

                The ID of the secret group the secret is inherited from.

              • priority

                integer required

                The priority of the secret group the secret is inherited from.

API
CLI
JS Client

GET /v1/projects/{projectId}/jobs/{jobId}/runtime-environment/details

Example response

200 OK

Details of the runtime environment of the job.

JSON

{
  "data": {
    "runtimeEnvironment": {
      "MY_VARIABLE_NAME": {
        "value": "abcdef123456",
        "inheritedFrom": "example-secret",
        "addonId": "example-addon",
        "priority": 10,
        "overriding": [
          {
            "value": "ffffffffffff",
            "inheritedFrom": "secret-2",
            "addonId": "addon-2",
            "priority": 0
          }
        ]
      }
    },
    "runtimeFiles": {
      "/dir/fileName": {
        "value": {
          "data": "VGhpcyBpcyBhbiBleGFtcGxlIHdpdGggYSB0ZW1wbGF0ZWQgJHtOT0RFX0VOVn0gdmFyaWFibGU=",
          "encoding": "utf-8"
        },
        "inheritedFrom": "example-secret",
        "priority": 10,
        "overriding": [
          {
            "value": "ffffffffffff",
            "inheritedFrom": "secret-2",
            "priority": 0
          }
        ]
      }
    }
  }
}

© 2024 Northflank Ltd. All rights reserved.