Get Prompts by ID - Kodexa Developer Portal

Get Prompts by ID

curl --request GET \
  --url https://platform.kodexa.ai/api/prompts/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://platform.kodexa.ai/api/prompts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.kodexa.ai/api/prompts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://platform.kodexa.ai/api/prompts/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform.kodexa.ai/api/prompts/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "changeSequence": 123,
  "createdOn": "2023-11-07T05:31:56Z",
  "deleted": true,
  "deprecated": true,
  "id": "<string>",
  "metadata": null,
  "name": "<string>",
  "organizationId": "<string>",
  "publicAccess": true,
  "slug": "<string>",
  "template": true,
  "updatedOn": "2023-11-07T05:31:56Z",
  "uuid": "<string>",
  "deleteUserEmail": "<string>",
  "deleteUserId": "<string>",
  "deletedDate": "2023-11-07T05:31:56Z",
  "extensionPackRef": "<string>",
  "orgSlug": "<string>",
  "organization": {
    "id": "<string>"
  },
  "ref": "<string>",
  "type": "<string>",
  "uri": "<string>",
  "yamlSource": "<string>"
}

GET

api

prompts

{id}

Get Prompts by ID

curl --request GET \
  --url https://platform.kodexa.ai/api/prompts/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://platform.kodexa.ai/api/prompts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.kodexa.ai/api/prompts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://platform.kodexa.ai/api/prompts/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform.kodexa.ai/api/prompts/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "changeSequence": 123,
  "createdOn": "2023-11-07T05:31:56Z",
  "deleted": true,
  "deprecated": true,
  "id": "<string>",
  "metadata": null,
  "name": "<string>",
  "organizationId": "<string>",
  "publicAccess": true,
  "slug": "<string>",
  "template": true,
  "updatedOn": "2023-11-07T05:31:56Z",
  "uuid": "<string>",
  "deleteUserEmail": "<string>",
  "deleteUserId": "<string>",
  "deletedDate": "2023-11-07T05:31:56Z",
  "extensionPackRef": "<string>",
  "orgSlug": "<string>",
  "organization": {
    "id": "<string>"
  },
  "ref": "<string>",
  "type": "<string>",
  "uri": "<string>",
  "yamlSource": "<string>"
}

Authorizations

x-api-key

string

header

required

API key for authentication. Create one from the Kodexa platform UI under Settings > Access Tokens.

Path Parameters

string<uuid>

required

Unique identifier (UUID) of the resource.

Response

The Prompts

Prompt metadata defines a prompt template used by AI assistants for document processing.

changeSequence

integer<int32>

required

Optimistic locking version number.

createdOn

string<date-time>

required

Timestamp when the prompt was created.

deleted

boolean

required

deprecated

boolean

required

Whether this prompt is deprecated.

string

required

Unique identifier (UUID) for the prompt.

metadata

unknown

required

name

string

required

Display name of the prompt.

organizationId

string

required

publicAccess

boolean

required

Whether the prompt is publicly accessible.

slug

string

required

URL-friendly identifier for the prompt.

template

boolean

required

Whether this prompt is a template.

updatedOn

string<date-time>

required

Timestamp when the prompt was last updated.

uuid

string

required

Secondary UUID identifier.

deleteUserEmail

string | null

deleteUserId

string | null

deletedDate

string<date-time> | null

extensionPackRef

string

orgSlug

string

organization

object | null

Show child attributes

ref

string

type

string

uri

string

Computed resource URI (scheme://orgSlug/slug), present on serialized responses.

yamlSource

string | null