Skip to content
FloralityDocs
ChangelogGet an API key

Getting started

  • Quickstart
  • Authentication
  • Scopes
  • Privacy buckets
  • Rate limits
  • Errors
  • Versioning
  • Terminology
  • Webhooks PRO

Resources

  • Members
  • Groups
  • Entries
  • Front
  • Appearance
  • Custom fields
  • Trash
  • Search
  • Member statuses
  • Systems
  • Messaging
  • Privacy buckets
  • Terminology
  • Friends
  • Subscriptions
  • Billing
  • Import
  • Social
  • Guestbook & poll
  • Group layout
  • Activity
Docs/Resources/patch import runs runid
Florality

Organise your system. One front at a time.

Get started

Product

  • Features
  • Pricing
  • Docs
  • Changelog
  • Security

Company

  • About
  • Our team
  • Blog
  • Contact

Resources

  • FAQ
  • Trust and Safety
  • Public REST API

Legal

  • Privacy Policy
  • Terms of Service
  • Refunds and cancellation

© 2026 Florality. All rights reserved.

Florality
ImportUpdate import run

Update import run

Updates import run for the authorised account.

PATCH
/api/v1/import/runs/{runId}
import: read_write1,000 requests/minute/key · all plans

Active API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.

Parameters

Path parameters

NameTypeRequiredDescription
runIdstring (uuid)RequiredIdentifier of the run.

Request body

application/json · required

NameTypeRequiredDescription
statusstringOptionalStatus. Allowed values: "running", "completed", "failed".
summaryobjectOptionalSummary.
summary.directoriesobjectRequiredDirectories.
summary.directories.creatednumberRequiredCreated.
summary.directories.skippednumberRequiredSkipped.
summary.directories.failednumberRequiredFailed.
summary.directories.updatednumberOptionalUpdated.
summary.membersobjectRequiredMembers.
summary.members.creatednumberRequiredCreated.
summary.members.skippednumberRequiredSkipped.
summary.members.failednumberRequiredFailed.
summary.members.updatednumberOptionalUpdated.
summary.entriesobjectRequiredEntries.
summary.entries.creatednumberRequiredCreated.
summary.entries.skippednumberRequiredSkipped.
summary.entries.failednumberRequiredFailed.
summary.entries.updatednumberOptionalUpdated.
summary.frontSessionsobjectRequiredFront Sessions.
summary.frontSessions.creatednumberRequiredCreated.
summary.frontSessions.skippednumberRequiredSkipped.
summary.frontSessions.failednumberRequiredFailed.
summary.frontSessions.updatednumberOptionalUpdated.
finishedAtnumberOptionalFinished At.
errorMessagestringOptionalError Message.
progressPhasestringOptionalProgress Phase.
progressPercentnumberOptionalProgress Percent.
progressDetailstringOptionalProgress Detail.

Response schema

204

Successful operation. No response body.

Errors

400 · JSON error

Request failed (BAD_REQUEST).

401 · JSON error

Missing or invalid API key. Use Authorization: Bearer <token>.

403 · JSON error

Requires import: read_write; ownership or feature restrictions may also deny access.

404 · JSON error

Request failed (NOT_FOUND).

409 · JSON error

Request failed (CONFLICT).

429 · JSON error

API rate limit exceeded (1000 requests per minute). Retry shortly.

503 · JSON error

PostgreSQL is not configured (DATABASE_URL).

← Previous endpointGet import runNext endpoint →List import runs

Request example

Set FLORALITY_KEY in your environment. These examples use demo identifiers.

Shell
curl --request PATCH 'https://floralitys.com/api/v1/import/runs/11111111-1111-4111-8111-111111111111' \
  --header "Authorization: Bearer $FLORALITY_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "status": "running"
}'

Responses

Successful operation. No response body.

No response body.

Example values are illustrative demo data.