Skip to content

The signup forms, for the block and the shortcode

GET
/api/v1/workspaces/{workspace}/wordpress/forms
curl --request GET \
--url https://reputecast.example.com/api/v1/workspaces/acme-newsletter/wordpress/forms \
--header 'Authorization: Bearer <token>'

Permission: subscribers:view

Keys: only a WordPress site’s key can call this operation.

subscribers:view lets a site’s key list forms only: it can’t read contacts.

workspace
required

Workspace slug

string
/^[a-z0-9][a-z0-9-]{1,62}$/

Workspace slug

OK

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
kind
required
string
name
required
string
script
required

The form’s public script, as embeds load it

string
shortcode
required
string
siteAllowed
required
boolean
status
required
string
Allowed values: draft live paused

Example

{
"items": [
{
"id": "frm_8c2e1a",
"shortcode": "[reputecast_form id=\"frm_8c2e1a\"]",
"status": "draft"
}
]
}

Error

Media typeapplication/problem+json
object
code

Stable error code, e.g. permission_denied

string
detail

A human-readable explanation specific to this occurrence of the problem.

string
errors

Optional list of individual error details

Array<object>
object
location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string
message

Error message text

string
value

The value at the given location

helpers

Members who hold the missing permission

Array<string>
instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri
meta
object
key
additional properties
permission

The missing permission key

string
status

HTTP status code

integer format: int64
title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string
type

A URI reference to human-readable documentation for the error.

string format: uri
default: about:blank

Example

{
"detail": "Property foo is required but is missing.",
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "about:blank"
}